This "contrib" directory is a place holder for code/scripts sent to me
by contributors around the world.  This README file will be kept
up-to-date from release to release.  BUT, we must point out that these
contributions are really, REALLY UNSUPPORTED.  In fact, we probably
don't even know what some of them really do.  We certainly do not
guarantee to have tried them, or ported them to work with this CVS
distribution.  If you have questions, your best bet is to contact the
original author, but you should not necessarily expect a reply, since
the author may not be available at the address given.

USE AT YOUR OWN RISK -- and all that stuff.

"Unsupported" also means that no one has volunteered to accept and check
in changes to this directory.  So submissions for new scripts to add
here are unlikely to be accepted.  Suggested changes to the existing
scripts here conceivably might, but that isn't clear either, unless of
course they come from the original author of the script.

If you have some software that works with CVS that you wish to offer it
is suggested that you make it available by FTP or HTTP and then announce
it on the info-cvs mailing list.

There is a web page of software related to CVS at the following URL which
would presumably be willing to list your software.

http://www.loria.fr/~molli/cvs-index.html

An attempt at a table of Contents for this directory:

READMEThis file.
logA perl script suitable for including in your
$CVSROOT/CVSROOT/loginfo file for logging commit
changes.  Includes the RCS revision of the change
as part of the log.
Contributed by Kevin Samborn <samborn@sunrise.com>.
commit_prepA perl script, to be combined with log_accum.pl, to
log_accumprovide for a way to combine the individual log
messages of a multi-directory "commit" into a
single log message, and mail the result somewhere.
Can also do other checks for $Id and that you are
committing the correct revision of the file.
Read the comments carefully.
Contributed by David Hampton <hampton@cisco.com>.
mfpipeAnother perl script for logging.  Allows you to
pipe the log message to a file and/or send mail
to some alias.
Contributed by John Clyne <clyne@niwot.scd.ucar.edu>.
rcs-to-cvsScript to import sources that may have been under
RCS control already.
Contributed by Per Cederqvist <ceder@lysator.liu.se>.
cvscheckIdentifies files added, changed, or removed in a
cvscheck.manchecked out CVS tree; also notices unknown files.
Contributed by Lowell Skoog <fluke!lowell@uunet.uu.net>
cvshelp.manAn introductory manual page written by Lowell Skoog
<fluke!lowell@uunet.uu.net>.  It is most likely
out-of-date relative to CVS 1.3, but still may be
useful.
dirfnsA shar file which contains some code that might
help your system support opendir/readdir/closedir,
if it does not already.
Copied from the C-News distribution.
rcslockA perl script that can be added to your commitinfo
file that tries to determine if your RCS file is
currently locked by someone else, as might be the
case for a binary file.
Contributed by John Rouillard <rouilj@cs.umb.edu>.
cvs_aclsA perl script that implements Access Control Lists
by using the "commitinfo" hook provided with the
"cvs commit" command.
Contributed by David G. Grubbs <dgg@ksr.com>.
descendA shell script that can be used to recursively
descend.mandescend through a directory.  In CVS 1.2, this was
very useful, since many of the commands were not
recursive.  In CVS 1.3 (and later), however, most of
the commands are recursive.  However, this may still
come in handy.
Contributed by Lowell Skoog <fluke!lowell@uunet.uu.net>
cln_histA perl script to compress your
$CVSROOT/CVSROOT/history file, as it can grow quite
large after extended use.
Contributed by David G. Grubbs <dgg@ksr.com>
sccs2rcsA C-shell script that can convert (some) SCCS files
into RCS files, retaining the info contained in the
SCCS file (like dates, author, and log message).
Contributed by Ken Cox <kenstir@viewlogic.com>.
intro.docA user's view of what you need to know to get
started with CVS.
Contributed by <Steven.Pemberton@cwi.nl>.
rcs2sccsA shell script to convert simple RCS files into
SCCS files, originally gleaned off the network
somewhere (originally by "kenc") and modified by
Jerry Jelinek <jerry@rmtc.Central.Sun.COM> and
Brian Berliner <berliner@sun.com> to increase
robustness and add support for one-level of branches.
rcs2logA shell script to create a ChangeLog-format file
given only a set of RCS files.
Contributed by Paul Eggert <eggert@twinsun.com>.
 clmergeA perl script to handle merge conflicts in GNU
style ChangeLog files .
Contributed by Tom Tromey <tromey@busco.lanl.gov>.
cvs2vendorA shell script to move changes from a repository
that was started without a vendor branch to one
that has a vendor branch.
Contributed by Greg A. Woods <woods@planix.com>