preliminary web config editor
[freeside.git] / FS / FS.pm
index 7831739..ca33300 100644 (file)
--- a/FS/FS.pm
+++ b/FS/FS.pm
@@ -14,122 +14,124 @@ FS - Freeside Perl modules
 
 =head1 SYNOPSIS
 
-FS is the temporary prefix for many disparate modules written for the Freeside
-ISP billing software.  This includes:
+FS is the unofficial (i.e. non-CPAN) prefix for the Perl module portion of the
+Freeside ISP billing software.  This includes:
 
-=head2 Database metadata classes
+=head2 Utility classes
 
-=over 4
+L<FS::Conf> - Freeside configuration values
 
-=item L<FS::dbdef|FS::dbdef> - Database class
+L<FS::ConfItem> - Freeside configuration option meta-data.
 
-=item L<FS::dbdef_table|FS::dbdef_table> - Database table class
+L<FS::UID> - User class (not yet OO)
 
-=item L<FS::dbdef_column|FS::dbdef_column> - Database column class
+L<FS::CGI> - Non OO-subroutines for the web interface.  This is
+depriciated.  Future development will be focused on the FS::UI user-interface
+classes (see below).
 
-=item L<FS::dbdef_colgroup|FS::dbdef_colgroup> - Database column group class
+=head2 Database record classes
 
-=item L<FS::dbdef_index|FS::dbdef_index> - Database index class
+L<FS::Record> - Database record base class
 
-=item L<FS::dbdef_unique|FS::dbdef_unique> - Database unique index class
+L<FS::svc_acct_pop> - POP (Point of Presence, not Post
+Office Protocol) class
 
-=back
+L<FS::part_pop_local> - Local calling area class
 
-=head2 Utility classes
+L<FS::part_referral> - Referral class
 
-=over 4
+L<FS::cust_main_county> - Locale (tax rate) class
 
-=item L<FS::SSH|FS::SSH> - Simple wrappers around ssh and scp commands.
+L<FS::svc_Common> - Service base class
 
-=item L<FS::Conf|FS::Conf> - Freeside configuration values
+L<FS::svc_acct> - Account (shell, RADIUS, POP3) class
 
-=item L<FS::UID|FS::UID> - User class (not yet OO)
+L<FS::svc_domain> - Domain class
 
-=item L<FS::CGI|FS::CGI> - Non OO-subroutines for the web interface.  This is
-depriciated.  Future development will be focused on the FS::UI user-interface
-classes (see below).
+L<FS::domain_record> - DNS zone entries
 
-=back
+L<FS::svc_forward> - Mail forwarding class
 
-=head2 Database record classes
+L<FS::svc_acct_sm> - (Depreciated) Vitual mail alias class
 
-=over 4
+L<FS::svc_www> - Web virtual host class.
 
-=item L<FS::Record|FS::Record> - Database record base class
+L<FS::part_svc> - Service definition class
 
-=item L<FS::svc_acct_pop|FS::svc_acct_pop> - POP (Point of Presence, not Post
-Office Protocol) class
+L<FS::part_svc_column> - Column constraint class
+
+L<FS::part_pkg> - Package (billing item) definition class
 
-=item L<FS::part_referral|FS::part_referral> - Referral class
+L<FS::pkg_svc> - Class linking package (billing item)
+definitions (see L<FS::part_pkg>) with service definitions
+(see L<FS::part_svc>)
 
-=item L<FS::cust_main_county|FS::cust_main_county> - Locale (tax rate) class
+L<FS::agent> - Agent (reseller) class
 
-=item L<FS::svc_Common|FS::svc_Common> - Service base class
+L<FS::agent_type> - Agent type class
 
-=item L<FS::svc_acct|FS::svc_acct> - Account (shell, RADIUS, POP3) class
+L<FS::type_pkgs> - Class linking agent types (see
+L<FS::agent_type>) with package (billing item) definitions
+(see L<FS::part_pkg>)
 
-=item L<FS::svc_domain|FS::svc_domain> - Domain class
+L<FS::cust_svc> - Service class
 
-=item L<FS::svc_acct_sm|FS::svc_acct_sm> - Vitual mail alias class
+L<FS::cust_pkg> - Package (billing item) class
 
-=item L<FS::part_svc|FS::part_svc> - Service definition class
+L<FS::cust_main> - Customer class
 
-=item L<FS::part_pkg|FS::part_pkg> - Package (billing item) definition class
+L<FS::cust_main_invoice> - Invoice destination
+class
 
-=item L<FS::pkg_svc|FS::pkg_svc> - Class linking package (billing item)
-definitions (see L<FS::part_pkg>) with service definitions
-(see L<FS::part_svc>)
+L<FS::cust_bill> - Invoice class
 
-=item L<FS::agent|FS::agent> - Agent (reseller) class
+L<FS::cust_bill_pkg> - Invoice line item class
 
-=item L<FS::agent_type|FS::agent_type> - Agent type class
+L<FS::cust_pay> - Payment class
 
-=item L<FS::type_pkgs|FS::type_pkgs> - Class linking agent types (see
-L<FS::agent_type>) with package (billing item) definitions
-(see L<FS::part_pkg>)
+L<FS::cust_bill_pay> - Payment application class
 
-=item L<FS::cust_svc|FS::cust_svc> - Service class
+L<FS::cust_credit> - Credit class
 
-=item L<FS::cust_pkg|FS::cust_pkg> - Package (billing item) class
+L<FS::cust_refund> - Refund class
 
-=item L<FS::cust_main|FS::cust_main> - Customer class
+L<FS::cust_credit_refund> - Refund application class
 
-=item L<FS::cust_main_invoice|FS::cust_main_invoice> - Invoice destination
-class
+L<FS::cust_credit_bill> - Credit invoice application class
 
-=item L<FS::cust_bill|FS::cust_bill> - Invoice class
+L<FS::cust_pay_batch> - Credit card transaction queue class
 
-=item L<FS::cust_bill_pkg|FS::cust_bill_pkg> - Invoice line item class
+L<FS::prepay_credit> - Prepaid "calling card" credit class.
 
-=item L<FS::cust_pay|FS::cust_pay> - Payment class
+L<FS::nas> - Network Access Server class
 
-=item L<FS::cust_credit|FS::cust_credit> - Credit class
+L<FS::port> - NAS port class
 
-=item L<FS::cust_refund|FS::cust_refund> - Refund class
+L<FS::session> - User login session class
 
-=item L<FS::cust_pay_batch|FS::cust_pay_batch> - Credit card transaction queue
-class
+L<FS::queue> - Job queue
 
-=back
+L<FS::queue_arg> - Job arguments
 
 =head2 User Interface classes (under development; not yet usable)
 
-=over 4
-
-=item L<FS::UI::Base|FS::UI::Base> - User-interface base class
+L<FS::UI::Base> - User-interface base class
 
-=item L<FS::UI::Gtk|FS::UI::Gtk> - Gtk user-interface class
+L<FS::UI::Gtk> - Gtk user-interface class
 
-=item L<FS::UI::CGI|FS::UI::CGI> - CGI (HTML) user-interface class
+L<FS::UI::CGI> - CGI (HTML) user-interface class
 
-=item L<FS::UI::agent|FS::UI::agent> - agent table user-interface class
+L<FS::UI::agent> - agent table user-interface class
 
-=back
+=head2 Notes
 
 To quote perl(1), "If you're intending to read these straight through for the
 first time, the suggested order will tend to reduce the number of forward
 references."
 
+If you've never used OO modules before,
+http://www.cpan.org/doc/FMTEYEWTK/easy_objects.html might help you out.
+
 =head1 DESCRIPTION
 
 Freeside is a billing and administration package for Internet Service
@@ -141,7 +143,7 @@ The main documentation is in htdocs/docs.
 
 =head1 VERSION
 
-$Id: FS.pm,v 1.2 1999-08-04 07:34:15 ivan Exp $
+$Id: FS.pm,v 1.10 2001-10-24 15:29:30 ivan Exp $
 
 =head1 SUPPORT
 
@@ -169,7 +171,8 @@ Freeside distribution, which are both different from the CVS version tag for
 each file, which appears under the VERSION heading.
 
 Those modules which would be useful separately should be pulled out, 
-renamed appropriately and uploaded to CPAN.
+renamed appropriately and uploaded to CPAN.  So far: DBIx::DBSchema, Net::SSH
+and Net::SCP...
 
 =cut