Bug 356926: contrib/README doesn't reflect reality - Patch by Sam Folk-Williams <sam.folkwilliams@gmail.com> r=vladd

1 files changed, 52 insertions, 26 deletions

diff --git a/contrib/README b/contrib/README
index a22a92575..32a5b6488 100644
--- a/contrib/README
+++ b/contrib/README
@@ -1,47 +1,73 @@
 This directory contains contributed software related to Bugzilla.
 Things in here have not necessarily been tested or tried by anyone
-except the original contributor, so tred carefully.  But it may still
-be useful to you.
+except the original contributor, so tread carefully.  But it may still
+be useful to you. Read the files themselves for detailed usage information
+on any specific script.
 
 This file is encoded in UTF8 for purposes of contributor names.
 
 This directory includes:
 
+bugzilla_ldapsync.rb --  Script that can be run via Cron that queries an LDAP
+                         server for e-mail addresses to add Bugzilla users
+                         for. Will optionally disable Bugzilla users with
+                         no matching LDAP record. Contributed by Thomas
+                         Stromberg <thomas+bugzilla@stromberg.org>.
+
     bugzilla-submit/ --  A standalone bug submission program.
 
-   mysqld-watcher.pl --  This script can be installed as a frequent cron 
-                         job to clean up stalled/dead queries.
+         bzdbcopy.pl --  A script to copy data from an installation running 
+                         on one DB platform to an installation running on 
+                         another DB platform.
 
-       sendbugmail.pl -- This script is a drop-in replacement for the
-                         'processmail' script which used to be shipped
-                         with Bugzilla, but was replaced by the
-                         Bugzilla/BugMail.pm Perl module.  You can use
-                         this script if you were previously calling
-                         processmail from other scripts external to
-                         Bugzilla.  See the comments at the top of
-                         the file for usage information.  Contributed
-                         by Nick Barnes of Ravenbrook Limited.
+bz_webservice_demo.p --  An example script that demonstrates how to talk to
+                         Bugzilla via XMLRPC.
+
+             cmdline/ -- Various commands for querying your Bugzilla 
+                         installation.
+
+       cvs-update.pl --  Script to keep a record of all CVS updates made 
+                         from a given directory. The log is useful when
+                         changes need to be backed out.
 
          gnatsparse/ --  A Python script used to import a GNATS database
                          into Bugzilla.
 
-         gnats2bz.pl --  A perl script to help import bugs from a GNATS 
+         gnats2bz.pl --  A Perl script to help import bugs from a GNATS 
                          database into a Bugzilla database.  Contributed by
-                         Tom Schutter <tom@platte.com>
- 
-        yp_nomail.sh --  Script you can run via cron that regularly updates
-                         the nomail file for terminated employees 
+                         Tom Schutter <tom@platte.com>.
 
-bugzilla_ldapsync.rb --  Script you can run via cron that queries an LDAP
-                         server for e-mail addresses to add Bugzilla users
-                         for. Will optionally disable Bugzilla users with
-                         no matching LDAP record. Contributed by Thomas
-                         Stromberg <thomas+bugzilla@stromberg.org>
+            jb2bz.py --  Script to import bugs from JitterBug to Bugzilla.
+
+      merge-users.pl --  Script to merge two user accounts. The activities
+                         from one account are moved to the another. Specify
+                         both accounts on the command line. The new account
+                         must already exist. 
+
+   mysqld-watcher.pl --  This script can be installed as a frequent Cron 
+                         job to clean up stalled/dead queries.
+
+           recode.pl --  Script to convert a database from one encoding 
+                         (or multiple encodings)  to UTF-8.
+
+      sendbugmail.pl --  This script is a drop-in replacement for the
+                         'processmail' script which used to be shipped
+                         with Bugzilla, but was replaced by the
+                         Bugzilla/BugMail.pm Perl module. This script can 
+                         be used if 'processmail' was previously called
+                         from other scripts external to
+                         Bugzilla.  See the comments at the top of
+                         the file for usage information. Contributed
+                         by Nick Barnes of Ravenbrook Limited.
+
+sendunsentbugmail.pl --  Script to find bugs with un-sent mail and to
+                         send all unsent messages.
 
-         syncLDAP.pl --  Script you can run via cron that queries an LDAP
+         syncLDAP.pl --  Script that can be run via Cron that queries an LDAP
                          server for users and e-mail addresses and adds
                          missing users to Bugzilla. Can disable/update 
                          non-existing/changed information. Contributed by
-                         Andreas Höfler <andreas.hoefler@bearingpoint.com>
-
+                         Andreas Höfler <andreas.hoefler@bearingpoint.com>.
 
+        yp_nomail.sh --  Script that can be run via Cron that regularly updates
+                         the nomail file for terminated employees.