xref: /openbsd/gnu/usr.bin/cvs/contrib/README (revision 133306f0)
1This "contrib" directory is a place holder for code/scripts sent to me
2by contributors around the world.  This README file will be kept
3up-to-date from release to release.  BUT, we must point out that these
4contributions are really, REALLY UNSUPPORTED.  In fact, we probably
5don't even know what some of them really do.  We certainly do not
6guarantee to have tried them, or ported them to work with this CVS
7distribution.  If you have questions, your best bet is to contact the
8original author, but you should not necessarily expect a reply, since
9the author may not be available at the address given.
10
11USE AT YOUR OWN RISK -- and all that stuff.
12
13"Unsupported" also means that no one has volunteered to accept and check
14in changes to this directory.  So submissions for new scripts to add
15here are unlikely to be accepted.  Suggested changes to the existing
16scripts here conceivably might, but that isn't clear either, unless of
17course they come from the original author of the script.
18
19If you have some software that works with CVS that you wish to offer it
20is suggested that you make it available by FTP or HTTP and then announce
21it on the info-cvs mailing list.
22
23There is a web page of software related to CVS at the following URL which
24would presumably be willing to list your software.
25
26	http://www.loria.fr/~molli/cvs-index.html
27
28An attempt at a table of Contents for this directory:
29
30	README		This file.
31	log		A perl script suitable for including in your
32			$CVSROOT/CVSROOT/loginfo file for logging commit
33			changes.  Includes the RCS revision of the change
34			as part of the log.
35			Contributed by Kevin Samborn <samborn@sunrise.com>.
36	commit_prep	A perl script, to be combined with log_accum.pl, to
37	log_accum	provide for a way to combine the individual log
38			messages of a multi-directory "commit" into a
39			single log message, and mail the result somewhere.
40			Can also do other checks for $Id and that you are
41			committing the correct revision of the file.
42			Read the comments carefully.
43			Contributed by David Hampton <hampton@cisco.com>.
44	mfpipe		Another perl script for logging.  Allows you to
45			pipe the log message to a file and/or send mail
46			to some alias.
47			Contributed by John Clyne <clyne@niwot.scd.ucar.edu>.
48	rcs-to-cvs	Script to import sources that may have been under
49			RCS control already.
50			Contributed by Per Cederqvist <ceder@lysator.liu.se>.
51	cvscheck	Identifies files added, changed, or removed in a
52	cvscheck.man	checked out CVS tree; also notices unknown files.
53			Contributed by Lowell Skoog <fluke!lowell@uunet.uu.net>
54	cvshelp.man	An introductory manual page written by Lowell Skoog
55			<fluke!lowell@uunet.uu.net>.  It is most likely
56			out-of-date relative to CVS 1.3, but still may be
57			useful.
58	dirfns		A shar file which contains some code that might
59			help your system support opendir/readdir/closedir,
60			if it does not already.
61			Copied from the C-News distribution.
62	rcslock		A perl script that can be added to your commitinfo
63			file that tries to determine if your RCS file is
64			currently locked by someone else, as might be the
65			case for a binary file.
66			Contributed by John Rouillard <rouilj@cs.umb.edu>.
67	cvs_acls	A perl script that implements Access Control Lists
68			by using the "commitinfo" hook provided with the
69			"cvs commit" command.
70			Contributed by David G. Grubbs <dgg@ksr.com>.
71	descend		A shell script that can be used to recursively
72	descend.man	descend through a directory.  In CVS 1.2, this was
73			very useful, since many of the commands were not
74			recursive.  In CVS 1.3 (and later), however, most of
75			the commands are recursive.  However, this may still
76			come in handy.
77			Contributed by Lowell Skoog <fluke!lowell@uunet.uu.net>
78	cln_hist	A perl script to compress your
79			$CVSROOT/CVSROOT/history file, as it can grow quite
80			large after extended use.
81			Contributed by David G. Grubbs <dgg@ksr.com>
82	sccs2rcs	A C-shell script that can convert (some) SCCS files
83			into RCS files, retaining the info contained in the
84			SCCS file (like dates, author, and log message).
85			Contributed by Ken Cox <kenstir@viewlogic.com>.
86	intro.doc	A user's view of what you need to know to get
87			started with CVS.
88			Contributed by <Steven.Pemberton@cwi.nl>.
89	rcs2sccs	A shell script to convert simple RCS files into
90			SCCS files, originally gleaned off the network
91			somewhere (originally by "kenc") and modified by
92			Jerry Jelinek <jerry@rmtc.Central.Sun.COM> and
93			Brian Berliner <berliner@sun.com> to increase
94			robustness and add support for one-level of branches.
95	rcs2log		A shell script to create a ChangeLog-format file
96			given only a set of RCS files.
97			Contributed by Paul Eggert <eggert@twinsun.com>.
98 	clmerge		A perl script to handle merge conflicts in GNU
99			style ChangeLog files .
100			Contributed by Tom Tromey <tromey@busco.lanl.gov>.
101	cvs2vendor	A shell script to move changes from a repository
102			that was started without a vendor branch to one
103			that has a vendor branch.
104			Contributed by Greg A. Woods <woods@planix.com>
105