RT# 81961 Repair broken links in POD documentation

- Update many links
- chmod a+x scripts in FS/bin, so Pod::Simple::HTMLBatch will
  parse them for POD documentation

107 files changed, 95 insertions, 51 deletions

diff --git a/FS/FS.pm b/FS/FS.pm
index e1d65f9e7..2523d7c4d 100644
--- a/FS/FS.pm
+++ b/FS/FS.pm
@@ -53,7 +53,7 @@ L<FS::Report::Table> - Report data objects
 
 L<FS::Report::Table::Monthly> - Report data objects
 
-L<FS::XMLRPC> - Backend XML::RPC server
+L<FS::ClientAPI_XMLRPC> - Backend XML::RPC server
 
 L<FS::Misc> - Miscellaneous subroutines
 
@@ -284,7 +284,7 @@ L<FS::rate_detail> - Rate plan detail for call billing
 
 L<FS::rate_tier> - Rate tiers for call billing
 
-L<FS::rate_tier_details> - Rater tier details for call billing
+L<FS::rate_tier_detail> - Rater tier details for call billing
 
 L<FS::usage_class> - Usage class class
 
@@ -530,8 +530,6 @@ L<freeside-dbdef-create> - Recreate database schema cache
 
 L<freeside-deluser> - Command line interface to delete (freeside) users.
 
-L<freeside-expiration-alerter> - Emails notifications of credit card expirations.
-
 L<freeside-email> -  Prints email addresses of all users on STDOUT
 
 L<freeside-fetch> - Send a freeside page to a list of employees.
diff --git a/FS/FS/ClientAPI.pm b/FS/FS/ClientAPI.pm
index 1fea28c67..2a880687e 100644
--- a/FS/FS/ClientAPI.pm
+++ b/FS/FS/ClientAPI.pm
@@ -11,6 +11,16 @@ $me = '[FS::ClientAPI]';
 
 %handler = ();
 
+=head1 NAME
+
+FS::ClientAPI
+
+=item load_clientapi_modules
+
+=cut
+
+=cut
+
 sub load_clientapi_modules {
 
   #find modules
@@ -31,6 +41,10 @@ sub load_clientapi_modules {
 
 }
 
+=item dispatch [ name ]
+
+=cut
+
 sub dispatch {
   my ( $self, $name ) = ( shift, shift );
   $name =~ s(/)(::)g;
diff --git a/FS/FS/Cron/upload.pm b/FS/FS/Cron/upload.pm
index 6a4d153f8..691170af9 100644
--- a/FS/FS/Cron/upload.pm
+++ b/FS/FS/Cron/upload.pm
@@ -474,7 +474,7 @@ sub spool_upload {
 
 Retrieves the config value named CONFIG, parses it as a Text::Template,
 extracts "to" and "subject" headers, and returns a hash that can be passed
-to L<FS::Misc::send_email>.
+to L<FS::Misc/send_email>.
 
 PARAMS is a hashref to be passed to C<fill_in>.  It must contain 
 'agentnum' to look up the per-agent config.
diff --git a/FS/FS/PagedSearch.pm b/FS/FS/PagedSearch.pm
index e740965ea..a1cd06818 100644
--- a/FS/FS/PagedSearch.pm
+++ b/FS/FS/PagedSearch.pm
@@ -31,7 +31,7 @@ while ( my $row = $search->fetch ) {
 
 =item psearch ARGUMENTS
 
-A wrapper around L<FS::Record::qsearch>.  Accepts all the same arguments 
+A wrapper around L<FS::Record/qsearch>.  Accepts all the same arguments 
 as qsearch, except for the arrayref union query mode, and returns an 
 FS::PagedSearch object to access the rows of the query one at a time.  
 If the query doesn't contain an ORDER BY clause already, it will be ordered
diff --git a/FS/FS/Template_Mixin.pm b/FS/FS/Template_Mixin.pm
index 61ea45408..76680d270 100644
--- a/FS/FS/Template_Mixin.pm
+++ b/FS/FS/Template_Mixin.pm
@@ -2180,7 +2180,7 @@ notice name instead of "Invoice", optional
 
 =back
 
-Returns an argument list to be passed to L<FS::Misc::send_email>.
+Returns an argument list to be passed to L<FS::Misc/send_email>.
 
 =cut
 
diff --git a/FS/FS/UI/Web.pm b/FS/FS/UI/Web.pm
index d8117590c..0bb01566f 100644
--- a/FS/FS/UI/Web.pm
+++ b/FS/FS/UI/Web.pm
@@ -469,9 +469,9 @@ sub cust_sql_fields {
 =item join_cust_main [ TABLE[.CUSTNUM] ] [ LOCATION_TABLE[.LOCATIONNUM] ]
 
 Returns an SQL join phrase for the FROM clause so that the fields listed
-in L<cust_sql_fields> will be available.  Currently joins to cust_main 
+in L</cust_sql_fields> will be available.  Currently joins to cust_main
 itself, as well as cust_location (under the aliases 'bill_location' and
-'ship_location') if address fields are needed.  L<cust_header()> should have
+'ship_location') if address fields are needed.  L</cust_header> should have
 been called already.
 
 All of these will be left joins; if you want to exclude rows with no linked
diff --git a/FS/FS/cust_bill.pm b/FS/FS/cust_bill.pm
index 2d937a827..5118f020e 100644
--- a/FS/FS/cust_bill.pm
+++ b/FS/FS/cust_bill.pm
@@ -1337,7 +1337,7 @@ sub ftp_invoice {
 
 =item spool_invoice [ TEMPLATENAME ] 
 
-Spools this invoice data (see L<FS::spool_csv>)
+Spools this invoice data (see L<FS::cust_bill/spool_csv>)
 
 TEMPLATENAME is unused?
 
@@ -3204,7 +3204,7 @@ The delete method.
 =head1 SEE ALSO
 
 L<FS::Record>, L<FS::cust_main>, L<FS::cust_bill_pay>, L<FS::cust_pay>,
-L<FS::cust_bill_pkg>, L<FS::cust_bill_credit>, schema.html from the base
+L<FS::cust_bill_pkg>, L<FS::cust_credit>, schema.html from the base
 documentation.
 
 =cut
diff --git a/FS/FS/cust_bill_void.pm b/FS/FS/cust_bill_void.pm
index 1f8119721..56933710a 100644
--- a/FS/FS/cust_bill_void.pm
+++ b/FS/FS/cust_bill_void.pm
@@ -285,7 +285,7 @@ sub cust_pkg {
 
 Class method which returns an SQL WHERE fragment to search for parameters
 specified in HASHREF.  Accepts the following parameters for 
-L<FS::cust_bill::search_sql_where>: C<_date>, C<invnum_min>, C<invnum_max>,
+L<FS::cust_bill/search_sql_where>: C<_date>, C<invnum_min>, C<invnum_max>,
 C<agentnum>, C<custnum>, C<cust_classnum>, C<refnum>, C<payby>.  Also 
 accepts the following:
 
diff --git a/FS/FS/cust_credit_bill_pkg.pm b/FS/FS/cust_credit_bill_pkg.pm
index ac13b520f..a54471db3 100644
--- a/FS/FS/cust_credit_bill_pkg.pm
+++ b/FS/FS/cust_credit_bill_pkg.pm
@@ -42,7 +42,7 @@ The following fields are currently supported:
 
 =item creditbillpkgnum -  primary key
 
-=item creditbillnum - Credit application to the overall invoice (see L<FS::cust_credit::bill>)
+=item creditbillnum - Credit application to the overall invoice (see L<FS::cust_credit_bill>)
 
 =item billpkgnum - Line item to which credit is applied (see L<FS::cust_bill_pkg>)
 
diff --git a/FS/FS/cust_main.pm b/FS/FS/cust_main.pm
index d0d85b93a..005931a2a 100644
--- a/FS/FS/cust_main.pm
+++ b/FS/FS/cust_main.pm
@@ -267,7 +267,7 @@ Enable individual CDR spooling, empty or `Y'
 
 =item dundate
 
-A suggestion to events (see L<FS::part_bill_event">) to delay until this unix timestamp
+A suggestion to events (see L<FS::part_bill_event>) to delay until this unix timestamp
 
 =item squelch_cdr
 
@@ -2433,7 +2433,7 @@ FS::cust_pkg::cancel() methods.
 
 =item quiet - can be set true to supress email cancellation notices.
 
-=item reason - can be set to a cancellation reason (see L<FS:reason>), either a
+=item reason - can be set to a cancellation reason (see L<FS::reason>), either a
 reasonnum of an existing reason, or passing a hashref will create a new reason.
 The hashref should have the following keys:
 typenum - Reason type (see L<FS::reason_type>)
@@ -3173,7 +3173,7 @@ UNIX timestamps; see L<perlfunc/"time">).  Also see L<Time::Local> and
 L<Date::Parse> for conversion functions.  The empty string can be passed
 to disable that time constraint completely.
 
-Accepts the same options as L<balance_date_sql>:
+Accepts the same options as L</balance_date_sql>:
 
 =over 4
 
diff --git a/FS/FS/cust_main_Mixin.pm b/FS/FS/cust_main_Mixin.pm
index 473bdd299..097111f38 100644
--- a/FS/FS/cust_main_Mixin.pm
+++ b/FS/FS/cust_main_Mixin.pm
@@ -358,7 +358,7 @@ Queue job for status updates.  Required.
 
 =item search
 
-Hashref of params to the L<search()> method.  Required.
+Hashref of params to the L<FS::Record/search> method.  Required.
 
 =item msgnum
 
diff --git a/FS/FS/cust_pay_batch.pm b/FS/FS/cust_pay_batch.pm
index a4129dc49..3cc8a7c93 100644
--- a/FS/FS/cust_pay_batch.pm
+++ b/FS/FS/cust_pay_batch.pm
@@ -236,7 +236,7 @@ sub expmmyy {
 
 =item pay_batch
 
-Returns the payment batch this payment belongs to (L<FS::pay_batch).
+Returns the payment batch this payment belongs to (L<FS::pay_batch>).
 
 =cut
 
@@ -509,8 +509,8 @@ sub process_unbatch_and_delete {
 =item unbatch_and_delete
 
 May only be called on a record with an empty status and an associated
-L<pay_batch> with a status of 'O' (not yet in transit.)  Deletes all associated
-records from L<cust_bill_pay_batch> and then deletes this record.
+L<FS::pay_batch> with a status of 'O' (not yet in transit.)  Deletes all associated
+records from L<FS::cust_bill_pay_batch> and then deletes this record.
 If there is an error, returns the error, otherwise returns false.
 
 =cut
diff --git a/FS/FS/cust_pkg.pm b/FS/FS/cust_pkg.pm
index 360c9d70d..5dc3f4e4a 100644
--- a/FS/FS/cust_pkg.pm
+++ b/FS/FS/cust_pkg.pm
@@ -143,7 +143,7 @@ Billing item definition (see L<FS::part_pkg>)
 
 =item locationnum
 
-Optional link to package location (see L<FS::location>)
+Optional link to package location (see L<FS::cust_location>)
 
 =item order_date
 
@@ -554,7 +554,7 @@ Available options are:
 
 =item reason
 
-can be set to a cancellation reason (see L<FS:reason>), either a reasonnum of an existing reason, or passing a hashref will create a new reason.  The hashref should have the following keys: typenum - Reason type (see L<FS::reason_type>, reason - Text of the new reason.
+can be set to a cancellation reason (see L<FS::reason>), either a reasonnum of an existing reason, or passing a hashref will create a new reason.  The hashref should have the following keys: typenum - Reason type (see L<FS::reason_type>, reason - Text of the new reason.
 
 =item reason_otaker
 
@@ -1497,7 +1497,7 @@ Available options are:
 
 =over 4
 
-=item reason - can be set to a cancellation reason (see L<FS:reason>),
+=item reason - can be set to a cancellation reason (see L<FS::reason>),
 either a reasonnum of an existing reason, or passing a hashref will create 
 a new reason.  The hashref should have the following keys: 
 - typenum - Reason type (see L<FS::reason_type>
@@ -4630,7 +4630,7 @@ Available options are:
 
 =item reason
 
-can be set to a cancellation reason (see L<FS:reason>), either a reasonnum of an existing reason, or passing a hashref will create a new reason.  The hashref should have the following keys: typenum - Reason type (see L<FS::reason_type>, reason - Text of the new reason.
+can be set to a cancellation reason (see L<FS::reason>), either a reasonnum of an existing reason, or passing a hashref will create a new reason.  The hashref should have the following keys: typenum - Reason type (see L<FS::reason_type>, reason - Text of the new reason.
 
 =item reason_otaker
 
diff --git a/FS/FS/cust_tax_exempt_pkg.pm b/FS/FS/cust_tax_exempt_pkg.pm
index 29f631473..6c4c64140 100644
--- a/FS/FS/cust_tax_exempt_pkg.pm
+++ b/FS/FS/cust_tax_exempt_pkg.pm
@@ -72,7 +72,7 @@ may be the setup fee, the recurring fee, or the sum of those.
 (cust_main.tax = 'Y').
 
 =item exempt_cust_taxname - flag indicating that the customer is exempt 
-from the tax with this name (see L<FS::cust_main_exemption).
+from the tax with this name (see L<FS::cust_main_exemption>).
 
 =item exempt_setup, exempt_recur: flag indicating that the package's setup
 or recurring fee is not taxable (part_pkg.setuptax and part_pkg.recurtax).
diff --git a/FS/FS/hardware_type.pm b/FS/FS/hardware_type.pm
index f19a3f683..a84470bfa 100644
--- a/FS/FS/hardware_type.pm
+++ b/FS/FS/hardware_type.pm
@@ -26,7 +26,7 @@ FS::hardware_type - Object methods for hardware_type records
 =head1 DESCRIPTION
 
 An FS::hardware_type object represents a device type (a model name or 
-number) assignable as a hardware service (L<FS::svc_hardware)>).
+number) assignable as a hardware service (L<FS::svc_hardware>).
 FS::hardware_type inherits from FS::Record.  The following fields are 
 currently supported:
 
diff --git a/FS/FS/inventory_item.pm b/FS/FS/inventory_item.pm
index 477c93410..61a929cac 100644
--- a/FS/FS/inventory_item.pm
+++ b/FS/FS/inventory_item.pm
@@ -174,7 +174,7 @@ maybe batch_import should be a regular method in FS::inventory_class
 
 =head1 SEE ALSO
 
-L<inventory_class>, L<cust_svc>, L<FS::Record>, schema.html from the base
+L<FS::inventory_class>, L<FS::cust_svc>, L<FS::Record>, schema.html from the base
 documentation.
 
 =cut
diff --git a/FS/FS/legacy_cust_bill.pm b/FS/FS/legacy_cust_bill.pm
index b2bfeaaad..bdf6b8457 100644
--- a/FS/FS/legacy_cust_bill.pm
+++ b/FS/FS/legacy_cust_bill.pm
@@ -47,7 +47,7 @@ Invoice number or identifier from previous system
 
 =item custnum
 
-Customer (see L<FS::cust_main)
+Customer (see L<FS::cust_main>)
 
 =item _date
 
diff --git a/FS/FS/legacy_cust_history.pm b/FS/FS/legacy_cust_history.pm
index 9e149036b..e214d7241 100644
--- a/FS/FS/legacy_cust_history.pm
+++ b/FS/FS/legacy_cust_history.pm
@@ -37,7 +37,7 @@ primary key
 
 =item custnum
 
-Customer (see L<FS::cust_main)
+Customer (see L<FS::cust_main>)
 
 =item history_action
 
diff --git a/FS/FS/part_event.pm b/FS/FS/part_event.pm
index 44ed4165f..78316248f 100644
--- a/FS/FS/part_event.pm
+++ b/FS/FS/part_event.pm
@@ -651,7 +651,7 @@ sub process_initialize {
 =head1 SEE ALSO
 
 L<FS::part_event_option>, L<FS::part_event_condition>, L<FS::cust_main>,
-L<FS::cust_pkg>, L<FS::svc_acct>, L<FS::cust_bill>, L<FS::cust_bill_event>, 
+L<FS::cust_pkg>, L<FS::svc_acct>, L<FS::cust_bill>, L<FS::cust_event>,
 L<FS::Record>,
 schema.html from the base documentation.
 
diff --git a/FS/FS/part_svc.pm b/FS/FS/part_svc.pm
index 7bf3d5aaf..a80c195c8 100644
--- a/FS/FS/part_svc.pm
+++ b/FS/FS/part_svc.pm
@@ -52,7 +52,7 @@ FS::Record.  The following fields are currently supported:
 =item svcdb - table used for this service.  See L<FS::svc_acct>,
 L<FS::svc_domain>, and L<FS::svc_forward>, among others.
 
-=item classnum - Optional service class (see L<FS::svc_class>)
+=item classnum - Optional service class (see L<FS::part_svc_class>)
 
 =item disabled - Disabled flag, empty or `Y'
 
diff --git a/FS/FS/radius_usergroup.pm b/FS/FS/radius_usergroup.pm
index 8085fe805..dae61687e 100644
--- a/FS/FS/radius_usergroup.pm
+++ b/FS/FS/radius_usergroup.pm
@@ -163,7 +163,7 @@ sub _upgrade_data {  #class method
 
 =head1 SEE ALSO
 
-L<svc_acct>, L<FS::radius_group>, L<FS::Record>, schema.html from the base documentation.
+L<FS::svc_acct>, L<FS::radius_group>, L<FS::Record>, schema.html from the base documentation.
 
 =cut
 
diff --git a/FS/FS/sales.pm b/FS/FS/sales.pm
index d1f473175..7c9269f10 100644
--- a/FS/FS/sales.pm
+++ b/FS/FS/sales.pm
@@ -40,7 +40,7 @@ primary key
 
 =item agentnum
 
-agentnum
+Agent (see L<FS::agent>)
 
 =item disabled
 
diff --git a/FS/FS/svc_Parent_Mixin.pm b/FS/FS/svc_Parent_Mixin.pm
index 4501bafc8..a63921f62 100644
--- a/FS/FS/svc_Parent_Mixin.pm
+++ b/FS/FS/svc_Parent_Mixin.pm
@@ -76,7 +76,7 @@ sub children_svc_x {
 This class provides a check subroutine which takes care of checking the
 parent_svcnum field.  The svc_ class which uses it will call SUPER::check at
 the end of its own checks, and this class will call NEXT::check to pass 
-the check "up the chain" (see L<NEXT>).
+the check "up the chain" (see L<perlfunc/next>).
 
 =cut
 
diff --git a/FS/FS/svc_acct.pm b/FS/FS/svc_acct.pm
index 9c82da191..efe6c73bb 100644
--- a/FS/FS/svc_acct.pm
+++ b/FS/FS/svc_acct.pm
@@ -2395,7 +2395,7 @@ sub is_rechargable {
 =item seconds_since TIMESTAMP
 
 Returns the number of seconds this account has been online since TIMESTAMP,
-according to the session monitor (see L<FS::Session>).
+according to the session monitor (see L<FS::session>).
 
 TIMESTAMP is specified as a UNIX timestamp; see L<perlfunc/"time">.  Also see
 L<Time::Local> and L<Date::Parse> for conversion functions.
diff --git a/FS/FS/type_pkgs.pm b/FS/FS/type_pkgs.pm
index 650375524..ebc6afa8c 100644
--- a/FS/FS/type_pkgs.pm
+++ b/FS/FS/type_pkgs.pm
@@ -121,7 +121,7 @@ sub agent_type {
 
 =head1 SEE ALSO
 
-L<FS::Record>, L<FS::agent_type>, L<FS::part_pkgs>, schema.html from the base
+L<FS::Record>, L<FS::agent_type>, L<FS::part_pkg>, schema.html from the base
 documentation.
 
 =cut
diff --git a/FS/bin/freeside-addoutsource b/FS/bin/freeside-addoutsource
index 9cb12195a..9cb12195a 100644..100755
--- a/FS/bin/freeside-addoutsource
+++ b/FS/bin/freeside-addoutsource
diff --git a/FS/bin/freeside-addoutsourceuser b/FS/bin/freeside-addoutsourceuser
index cbe792acc..cbe792acc 100644..100755
--- a/FS/bin/freeside-addoutsourceuser
+++ b/FS/bin/freeside-addoutsourceuser
diff --git a/FS/bin/freeside-adduser b/FS/bin/freeside-adduser
index 530481377..530481377 100644..100755
--- a/FS/bin/freeside-adduser
+++ b/FS/bin/freeside-adduser
diff --git a/FS/bin/freeside-aradial-sftp_and_import b/FS/bin/freeside-aradial-sftp_and_import
index 668ec49ba..668ec49ba 100644..100755
--- a/FS/bin/freeside-aradial-sftp_and_import
+++ b/FS/bin/freeside-aradial-sftp_and_import
diff --git a/FS/bin/freeside-backup b/FS/bin/freeside-backup
index 25e74a451..25e74a451 100644..100755
--- a/FS/bin/freeside-backup
+++ b/FS/bin/freeside-backup
diff --git a/FS/bin/freeside-bind-export b/FS/bin/freeside-bind-export
index a3bbd1ac5..a3bbd1ac5 100644..100755
--- a/FS/bin/freeside-bind-export
+++ b/FS/bin/freeside-bind-export
diff --git a/FS/bin/freeside-cdr-a2billing-import b/FS/bin/freeside-cdr-a2billing-import
index aa7fa4a61..aa7fa4a61 100644..100755
--- a/FS/bin/freeside-cdr-a2billing-import
+++ b/FS/bin/freeside-cdr-a2billing-import
diff --git a/FS/bin/freeside-cdr-freeswitch b/FS/bin/freeside-cdr-freeswitch
index 3c18ef2a6..3c18ef2a6 100644..100755
--- a/FS/bin/freeside-cdr-freeswitch
+++ b/FS/bin/freeside-cdr-freeswitch
diff --git a/FS/bin/freeside-cdr-import b/FS/bin/freeside-cdr-import
index 55a007008..55a007008 100644..100755
--- a/FS/bin/freeside-cdr-import
+++ b/FS/bin/freeside-cdr-import
diff --git a/FS/bin/freeside-cdr-mysql b/FS/bin/freeside-cdr-mysql
index fe0233b75..fe0233b75 100644..100755
--- a/FS/bin/freeside-cdr-mysql
+++ b/FS/bin/freeside-cdr-mysql
diff --git a/FS/bin/freeside-cdr-portaone-import b/FS/bin/freeside-cdr-portaone-import
index dfd130bbb..dfd130bbb 100644..100755
--- a/FS/bin/freeside-cdr-portaone-import
+++ b/FS/bin/freeside-cdr-portaone-import
diff --git a/FS/bin/freeside-cdr-thinktel b/FS/bin/freeside-cdr-thinktel
index 75a6d925c..75a6d925c 100644..100755
--- a/FS/bin/freeside-cdr-thinktel
+++ b/FS/bin/freeside-cdr-thinktel
diff --git a/FS/bin/freeside-cdr-voip_ms b/FS/bin/freeside-cdr-voip_ms
index 9c8dc7952..9c8dc7952 100644..100755
--- a/FS/bin/freeside-cdr-voip_ms
+++ b/FS/bin/freeside-cdr-voip_ms
diff --git a/FS/bin/freeside-cdrd b/FS/bin/freeside-cdrd
index 45d58789d..45d58789d 100644..100755
--- a/FS/bin/freeside-cdrd
+++ b/FS/bin/freeside-cdrd
diff --git a/FS/bin/freeside-cdrrated b/FS/bin/freeside-cdrrated
index a8fcf5157..a8fcf5157 100644..100755
--- a/FS/bin/freeside-cdrrated
+++ b/FS/bin/freeside-cdrrated
diff --git a/FS/bin/freeside-cdrrewrited b/FS/bin/freeside-cdrrewrited
index bb16059c3..bb16059c3 100644..100755
--- a/FS/bin/freeside-cdrrewrited
+++ b/FS/bin/freeside-cdrrewrited
diff --git a/FS/bin/freeside-censustract-update b/FS/bin/freeside-censustract-update
index af9ad749b..af9ad749b 100644..100755
--- a/FS/bin/freeside-censustract-update
+++ b/FS/bin/freeside-censustract-update
diff --git a/FS/bin/freeside-check b/FS/bin/freeside-check
index fdfc66af0..fdfc66af0 100644..100755
--- a/FS/bin/freeside-check
+++ b/FS/bin/freeside-check
diff --git a/FS/bin/freeside-deloutsource b/FS/bin/freeside-deloutsource
index afc3a0118..afc3a0118 100644..100755
--- a/FS/bin/freeside-deloutsource
+++ b/FS/bin/freeside-deloutsource
diff --git a/FS/bin/freeside-deloutsourceuser b/FS/bin/freeside-deloutsourceuser
index dc4ff9cdc..dc4ff9cdc 100644..100755
--- a/FS/bin/freeside-deloutsourceuser
+++ b/FS/bin/freeside-deloutsourceuser
diff --git a/FS/bin/freeside-deluser b/FS/bin/freeside-deluser
index a2a361a83..a2a361a83 100644..100755
--- a/FS/bin/freeside-deluser
+++ b/FS/bin/freeside-deluser
diff --git a/FS/bin/freeside-ipifony-download b/FS/bin/freeside-ipifony-download
index 1e77c3a75..1e77c3a75 100644..100755
--- a/FS/bin/freeside-ipifony-download
+++ b/FS/bin/freeside-ipifony-download
diff --git a/FS/bin/freeside-paymentech-download b/FS/bin/freeside-paymentech-download
index 4d99df2d0..d300f3edc 100755
--- a/FS/bin/freeside-paymentech-download
+++ b/FS/bin/freeside-paymentech-download
@@ -133,7 +133,7 @@ freeside-paymentech-download - Retrieve payment batch responses from Chase Payme
 
 Command line tool to download payment batch responses from the Chase Paymentech
 gateway.  These are XML files packaged in ZIP files.  This script downloads them 
-by SFTP, extracts the contents, and passes them to L<FS::pay_batch::import_result>.
+by SFTP, extracts the contents, and passes them to L<FS::pay_batch/import_results>.
 
 -v: Be verbose.
 
diff --git a/FS/bin/freeside-paymentech-upload b/FS/bin/freeside-paymentech-upload
index 2880f0e9e..137c38f1b 100755
--- a/FS/bin/freeside-paymentech-upload
+++ b/FS/bin/freeside-paymentech-upload
@@ -121,7 +121,7 @@ freeside-paymentech-upload - Transmit a payment batch to Chase Paymentech via SF
 
 Command line tool to upload a payment batch to the Chase Paymentech gateway.
 The batch will be exported to the Paymentech XML format, packaged in a ZIP 
-file, and transmitted via SFTP.  Use L<paymentech-download> to retrieve the 
+file, and transmitted via SFTP.  Use L<freeside-paymentech-download> to retrieve the
 response file.
 
 -a: Send all open batches, instead of specifying a batchnum.
diff --git a/FS/bin/freeside-prepaidd b/FS/bin/freeside-prepaidd
index cb8315435..cb8315435 100644..100755
--- a/FS/bin/freeside-prepaidd
+++ b/FS/bin/freeside-prepaidd
diff --git a/FS/bin/freeside-queued b/FS/bin/freeside-queued
index a6a7576a1..a6a7576a1 100644..100755
--- a/FS/bin/freeside-queued
+++ b/FS/bin/freeside-queued
diff --git a/FS/bin/freeside-radgroup b/FS/bin/freeside-radgroup
index 332632942..332632942 100644..100755
--- a/FS/bin/freeside-radgroup
+++ b/FS/bin/freeside-radgroup
diff --git a/FS/bin/freeside-reexport b/FS/bin/freeside-reexport
index 6b689178d..6b689178d 100644..100755
--- a/FS/bin/freeside-reexport
+++ b/FS/bin/freeside-reexport
diff --git a/FS/bin/freeside-selfservice-server b/FS/bin/freeside-selfservice-server
index f008285e5..4272caed5 100644..100755
--- a/FS/bin/freeside-selfservice-server
+++ b/FS/bin/freeside-selfservice-server
@@ -1,5 +1,11 @@
 #!/usr/bin/perl -w
 
+=head1 NAME
+
+freeside-selfservice-server
+
+=cut
+
 use strict;
 use vars qw( $FREESIDE_LOG $FREESIDE_LOCK );
 use vars qw( $Debug %kids $kids $max_kids $ssh_pid %old_ssh_pid $keepalives );
diff --git a/FS/bin/freeside-selfservice-xmlrpcd b/FS/bin/freeside-selfservice-xmlrpcd
index 88cfb7c62..9a8481e4d 100755
--- a/FS/bin/freeside-selfservice-xmlrpcd
+++ b/FS/bin/freeside-selfservice-xmlrpcd
@@ -3,9 +3,11 @@
 # based on http://www.perlmonks.org/?node_id=582781 by Justin Hawkins
 # and http://poe.perl.org/?POE_Cookbook/Web_Server_With_Forking
 
-###
-# modules and constants and variables, oh my
-###
+=head1 NAME
+
+freeside-selfservice-xmlrpcd
+
+=cut
 
 use warnings;
 use strict;
diff --git a/FS/bin/freeside-setinvoice b/FS/bin/freeside-setinvoice
index 708e2fa30..708e2fa30 100644..100755
--- a/FS/bin/freeside-setinvoice
+++ b/FS/bin/freeside-setinvoice
diff --git a/FS/bin/freeside-setup b/FS/bin/freeside-setup
index 155c74aa0..a6a66abc9 100755
--- a/FS/bin/freeside-setup
+++ b/FS/bin/freeside-setup
@@ -1,5 +1,11 @@
 #!/usr/bin/perl -w
 
+=head1 NAME
+
+freeside-setup
+
+=cut
+
 #to delay loading dbdef until we're ready
 BEGIN { $FS::Schema::setup_hack = 1; }
 
diff --git a/FS/bin/freeside-sqlradius-radacctd b/FS/bin/freeside-sqlradius-radacctd
index 7b2d04dc7..7b2d04dc7 100644..100755
--- a/FS/bin/freeside-sqlradius-radacctd
+++ b/FS/bin/freeside-sqlradius-radacctd
diff --git a/FS/bin/freeside-sqlradius-seconds b/FS/bin/freeside-sqlradius-seconds
index 9999cbbf3..9999cbbf3 100644..100755
--- a/FS/bin/freeside-sqlradius-seconds
+++ b/FS/bin/freeside-sqlradius-seconds
diff --git a/FS/bin/freeside-tax-district-update b/FS/bin/freeside-tax-district-update
index af43130d5..af43130d5 100644..100755
--- a/FS/bin/freeside-tax-district-update
+++ b/FS/bin/freeside-tax-district-update
diff --git a/FS/bin/freeside-torrus-srvderive b/FS/bin/freeside-torrus-srvderive
index 5ad23aba4..5ad23aba4 100644..100755
--- a/FS/bin/freeside-torrus-srvderive
+++ b/FS/bin/freeside-torrus-srvderive
diff --git a/FS/bin/freeside-vitelity-cdrimport b/FS/bin/freeside-vitelity-cdrimport
index 83bbdd96e..83bbdd96e 100644..100755
--- a/FS/bin/freeside-vitelity-cdrimport
+++ b/FS/bin/freeside-vitelity-cdrimport
diff --git a/FS/bin/freeside-voipinnovations-cdrimport b/FS/bin/freeside-voipinnovations-cdrimport
index 5eb2aef95..5eb2aef95 100644..100755
--- a/FS/bin/freeside-voipinnovations-cdrimport
+++ b/FS/bin/freeside-voipinnovations-cdrimport
diff --git a/FS/bin/freeside-xmlrpcd b/FS/bin/freeside-xmlrpcd
index e4e03345a..b6f15ce89 100644..100755
--- a/FS/bin/freeside-xmlrpcd
+++ b/FS/bin/freeside-xmlrpcd
@@ -1,5 +1,11 @@
 #!/usr/bin/perl
 
+=head1 NAME
+
+freeside-xmlrpcd
+
+=cut
+
 use FS::Daemon::Preforking qw( freeside_init1 freeside_init2 daemon_run );
 
 use FS::XMLRPC_Lite; #XMLRPC::Lite for XMLRPC::Serializer
diff --git a/FS/bin/freeside-yori b/FS/bin/freeside-yori
index d1137995d..d1137995d 100644..100755
--- a/FS/bin/freeside-yori
+++ b/FS/bin/freeside-yori
diff --git a/bin/artera.import b/bin/artera.import
index 716dddad0..716dddad0 100644..100755
--- a/bin/artera.import
+++ b/bin/artera.import
diff --git a/bin/backup-dvd b/bin/backup-dvd
index d0314b469..d0314b469 100644..100755
--- a/bin/backup-dvd
+++ b/bin/backup-dvd
diff --git a/bin/billco-upload b/bin/billco-upload
index a5f67cda4..a5f67cda4 100644..100755
--- a/bin/billco-upload
+++ b/bin/billco-upload
diff --git a/bin/breakdown-bill-applications b/bin/breakdown-bill-applications
index 44c3e36b0..44c3e36b0 100644..100755
--- a/bin/breakdown-bill-applications
+++ b/bin/breakdown-bill-applications
diff --git a/bin/cch.finish_failed b/bin/cch.finish_failed
index cb2533044..cb2533044 100644..100755
--- a/bin/cch.finish_failed
+++ b/bin/cch.finish_failed
diff --git a/bin/cch.redelete b/bin/cch.redelete
index 2cff389ad..2cff389ad 100644..100755
--- a/bin/cch.redelete
+++ b/bin/cch.redelete
diff --git a/bin/cdr-voipswitch.import b/bin/cdr-voipswitch.import
index 69d0636a7..69d0636a7 100644..100755
--- a/bin/cdr-voipswitch.import
+++ b/bin/cdr-voipswitch.import
diff --git a/bin/cdr.reimport b/bin/cdr.reimport
index 23060387d..23060387d 100644..100755
--- a/bin/cdr.reimport
+++ b/bin/cdr.reimport
diff --git a/bin/copy-cust_main_county b/bin/copy-cust_main_county
index 1a15e84f8..1a15e84f8 100644..100755
--- a/bin/copy-cust_main_county
+++ b/bin/copy-cust_main_county
diff --git a/bin/create-fetchmailrc b/bin/create-fetchmailrc
index 11bde0ce3..11bde0ce3 100644..100755
--- a/bin/create-fetchmailrc
+++ b/bin/create-fetchmailrc
diff --git a/bin/cust_main_special.pm b/bin/cust_main_special.pm
index 967b6be19..967b6be19 100644..100755
--- a/bin/cust_main_special.pm
+++ b/bin/cust_main_special.pm
diff --git a/bin/drop_slony.slonik b/bin/drop_slony.slonik
index 04ffaca7c..04ffaca7c 100644..100755
--- a/bin/drop_slony.slonik
+++ b/bin/drop_slony.slonik
diff --git a/bin/explain-bill-query b/bin/explain-bill-query
index e3f69781b..e3f69781b 100644..100755
--- a/bin/explain-bill-query
+++ b/bin/explain-bill-query
diff --git a/bin/find-overapplied b/bin/find-overapplied
index 7973cef5b..7973cef5b 100644..100755
--- a/bin/find-overapplied
+++ b/bin/find-overapplied
diff --git a/bin/follow-tax-rename b/bin/follow-tax-rename
index b7536e815..b7536e815 100644..100755
--- a/bin/follow-tax-rename
+++ b/bin/follow-tax-rename
diff --git a/bin/freeside-backup b/bin/freeside-backup
index 25e74a451..25e74a451 100644..100755
--- a/bin/freeside-backup
+++ b/bin/freeside-backup
diff --git a/bin/freeside-migrate-events b/bin/freeside-migrate-events
index 3e8a6b209..3e8a6b209 100644..100755
--- a/bin/freeside-migrate-events
+++ b/bin/freeside-migrate-events
diff --git a/bin/freeside-mysql.load b/bin/freeside-mysql.load
index 02f47daf3..02f47daf3 100644..100755
--- a/bin/freeside-mysql.load
+++ b/bin/freeside-mysql.load
diff --git a/bin/freeside.import b/bin/freeside.import
index fdfcc083e..fdfcc083e 100644..100755
--- a/bin/freeside.import
+++ b/bin/freeside.import
diff --git a/bin/import-did-inventory b/bin/import-did-inventory
index 01fa2e8af..01fa2e8af 100644..100755
--- a/bin/import-did-inventory
+++ b/bin/import-did-inventory
diff --git a/bin/merge-referrals b/bin/merge-referrals
index e39f053e8..e39f053e8 100644..100755
--- a/bin/merge-referrals
+++ b/bin/merge-referrals
diff --git a/bin/move-datasrc b/bin/move-datasrc
index e048cbee0..e048cbee0 100644..100755
--- a/bin/move-datasrc
+++ b/bin/move-datasrc
diff --git a/bin/pg-readonly b/bin/pg-readonly
index b5cde4d6e..b5cde4d6e 100644..100755
--- a/bin/pg-readonly
+++ b/bin/pg-readonly
diff --git a/bin/populate-areacodes b/bin/populate-areacodes
index 7e4c52fdc..7e4c52fdc 100644..100755
--- a/bin/populate-areacodes
+++ b/bin/populate-areacodes
diff --git a/bin/queue-bulk_change b/bin/queue-bulk_change
index 4fc22b3aa..4fc22b3aa 100644..100755
--- a/bin/queue-bulk_change
+++ b/bin/queue-bulk_change
diff --git a/bin/rate.delete b/bin/rate.delete
index 7b7e4bcf5..7b7e4bcf5 100644..100755
--- a/bin/rate.delete
+++ b/bin/rate.delete
diff --git a/bin/rt-setup-support-time b/bin/rt-setup-support-time
index 5f1007d8b..5f1007d8b 100644..100755
--- a/bin/rt-setup-support-time
+++ b/bin/rt-setup-support-time
diff --git a/bin/rt-update-links b/bin/rt-update-links
index 75d554f48..75d554f48 100644..100755
--- a/bin/rt-update-links
+++ b/bin/rt-update-links
diff --git a/bin/sales2agent b/bin/sales2agent
index 0be6b43f4..0be6b43f4 100644..100755
--- a/bin/sales2agent
+++ b/bin/sales2agent
diff --git a/bin/sendmail.import b/bin/sendmail.import
index ef745fc46..ef745fc46 100644..100755
--- a/bin/sendmail.import
+++ b/bin/sendmail.import
diff --git a/bin/sequences.reset b/bin/sequences.reset
index 2dc1d3bb2..2dc1d3bb2 100644..100755
--- a/bin/sequences.reset
+++ b/bin/sequences.reset
diff --git a/bin/sqlradius.import b/bin/sqlradius.import
index e75f65b17..e75f65b17 100644..100755
--- a/bin/sqlradius.import
+++ b/bin/sqlradius.import
diff --git a/bin/svc.replace b/bin/svc.replace
index a9ceadab2..a9ceadab2 100644..100755
--- a/bin/svc.replace
+++ b/bin/svc.replace
diff --git a/bin/svc_acct-recalculate_usage b/bin/svc_acct-recalculate_usage
index 1b3955b21..1b3955b21 100644..100755
--- a/bin/svc_acct-recalculate_usage
+++ b/bin/svc_acct-recalculate_usage
diff --git a/bin/test_scrub b/bin/test_scrub
index e39a28a4e..e39a28a4e 100644..100755
--- a/bin/test_scrub
+++ b/bin/test_scrub
diff --git a/bin/wipe-agent b/bin/wipe-agent
index 0e1846a63..0e1846a63 100644..100755
--- a/bin/wipe-agent
+++ b/bin/wipe-agent
diff --git a/bin/wipe-customers b/bin/wipe-customers
index e65ed61be..e65ed61be 100644..100755
--- a/bin/wipe-customers
+++ b/bin/wipe-customers
diff --git a/bin/xmlrpc-customer_package-status.pl b/bin/xmlrpc-customer_package-status.pl
index 589c42af4..589c42af4 100644..100755
--- a/bin/xmlrpc-customer_package-status.pl
+++ b/bin/xmlrpc-customer_package-status.pl
diff --git a/bin/xmlrpc-customer_packages-list.pl b/bin/xmlrpc-customer_packages-list.pl
index 745d30fbd..745d30fbd 100644..100755
--- a/bin/xmlrpc-customer_packages-list.pl
+++ b/bin/xmlrpc-customer_packages-list.pl
diff --git a/fs_selfservice/FS-SelfService/freeside-selfservice-clientd b/fs_selfservice/FS-SelfService/freeside-selfservice-clientd
index 0819d9d67..a3046cd44 100644..100755
--- a/fs_selfservice/FS-SelfService/freeside-selfservice-clientd
+++ b/fs_selfservice/FS-SelfService/freeside-selfservice-clientd
@@ -1,8 +1,14 @@
 #!/usr/bin/perl -w
-#
-# freeside-selfservice-clientd
-#
-# This is run REMOTELY over ssh by freeside-selfservice-server
+
+=head1 NAME
+
+freeside-selfservice-clientd
+
+=head1 DESCRIPTION
+
+This is run REMOTELY over ssh by freeside-selfservice-server
+
+=cut
 
 use strict;
 use subs qw(spawn logmsg lock_write unlock_write);
diff --git a/fs_selfservice/FS-SelfService/freeside-selfservice-soap-server b/fs_selfservice/FS-SelfService/freeside-selfservice-soap-server
index 869a8aecc..464e7ea51 100644
--- a/fs_selfservice/FS-SelfService/freeside-selfservice-soap-server
+++ b/fs_selfservice/FS-SelfService/freeside-selfservice-soap-server
@@ -1,7 +1,10 @@
 #!/usr/bin/perl -w
-#
-# freeside-selfservice-soap-server
-#
+
+=head1 NAME
+
+freeside-selfservice-soap-server
+
+=cut
 
 use strict;
 use Fcntl qw(:flock);
diff --git a/fs_selfservice/FS-SelfService/freeside-selfservice-xmlrpc-server b/fs_selfservice/FS-SelfService/freeside-selfservice-xmlrpc-server
index bd4f83b3c..801de56c6 100644
--- a/fs_selfservice/FS-SelfService/freeside-selfservice-xmlrpc-server
+++ b/fs_selfservice/FS-SelfService/freeside-selfservice-xmlrpc-server
@@ -1,7 +1,10 @@
 #!/usr/bin/perl -w
-#
-# freeside-selfservice-xmlrpc-server
-#
+
+=head1 NAME
+
+freeside-selfservice-xmlrpc-server
+
+=cut
 
 use strict;
 use Fcntl qw(:flock);