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 23An attempt at a table of Contents for this directory: 24 25 README This file. 26 27 clmerge A perl script to handle merge conflicts in GNU 28 style ChangeLog files . 29 Contributed by Tom Tromey <tromey@busco.lanl.gov>. 30 31 cln_hist A perl script to compress your 32 $CVSROOT/CVSROOT/history file, as it can grow quite 33 large after extended use. 34 Contributed by David G. Grubbs <dgg@ksr.com> 35 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 45 cvs2vendor A shell script to move changes from a repository 46 that was started without a vendor branch to one 47 that has a vendor branch. 48 Contributed by Greg A. Woods <woods@planix.com>. 49 50 cvs_acls A perl script that implements Access Control Lists 51 cvs_acls.html by using the "commitinfo" hook provided with the 52 "cvs commit" command. 53 Contributed by David G. Grubbs <dgg@ksr.com>. 54 Enhanced by Peter Connolly <Peter.Connolly@cnet.com>. 55 56 cvshelp.man An introductory manual page written by Lowell Skoog 57 <fluke!lowell@uunet.uu.net>. It is most likely 58 out-of-date relative to CVS 1.3, but still may be 59 useful. 60 61 debug_check_log A shell script to help analyze sanity check failures. 62 Contributed by Derek R. Price <derek@ximbiot.com>. 63 64 descend A shell script that can be used to recursively 65 descend.man descend through a directory. In CVS 1.2, this was 66 very useful, since many of the commands were not 67 recursive. In CVS 1.3 (and later), however, most of 68 the commands are recursive. However, this may still 69 come in handy. 70 Contributed by Lowell Skoog <fluke!lowell@uunet.uu.net> 71 72 dirfns A shar file which contains some code that might 73 help your system support opendir/readdir/closedir, 74 if it does not already. 75 Copied from the C-News distribution. 76 77 intro.doc A user's view of what you need to know to get 78 started with CVS. 79 Contributed by <Steven.Pemberton@cwi.nl>. 80 81 log A perl script suitable for including in your 82 $CVSROOT/CVSROOT/loginfo file for logging commit 83 changes. Includes the RCS revision of the change 84 as part of the log. 85 Contributed by Kevin Samborn <samborn@sunrise.com>. 86 87 log_accum See commit_prep. 88 89 mfpipe Another perl script for logging. Allows you to 90 pipe the log message to a file and/or send mail 91 to some alias. 92 Contributed by John Clyne <clyne@niwot.scd.ucar.edu>. 93 94 pvcs2rcs A perl script to convert a PVCS tree to an RCS tree. 95 96 rcs-5.7-commitid.patch 97 Patch to RCS 5.7 sources of 1995-06-16 to support 98 the newphrase 'commitid' used by CVS and CVSNT. 99 100 rcs-5.7-sameuserlocks.patch 101 Patch to RCS 5.7 sources from 2003-10-24 102 submitted to both help-rcs@gnu.org and Redhat. 103 Included in many Redhat GNU/Linux distribution 104 RPM files. A new -S switch to the co command 105 will disallow the user to check out the same 106 file twice. 107 108 rcs-5.7-security.patch 109 Patch to RCS 5.7 sources from 2001-01-05 110 included in many GNU/Linux distributions as applied 111 by Preston Brown <pbrown@redhat.com> 112 tmpfile security patch from Olaf Kirch <okir@lst.de>. 113 114 rcs-to-cvs Script to import sources that may have been under 115 RCS control already. 116 Contributed by Per Cederqvist <ceder@lysator.liu.se>. 117 118 rcs2log A shell script to create a ChangeLog-format file 119 given only a set of RCS files. 120 Contributed by Paul Eggert <eggert@twinsun.com>. 121 122 rcs2sccs A shell script to convert simple RCS files into 123 SCCS files, originally gleaned off the network 124 somewhere (originally by "kenc") and modified by 125 Jerry Jelinek <jerry@rmtc.Central.Sun.COM> and 126 Brian Berliner <berliner@sun.com> to increase 127 robustness and add support for one-level of branches. 128 129 rcslock A perl script that can be added to your commitinfo 130 file that tries to determine if your RCS file is 131 currently locked by someone else, as might be the 132 case for a binary file. 133 Contributed by John Rouillard <rouilj@cs.umb.edu>. 134 135 sandbox_status 136 sandbox_status.man 137 Identifies files added, changed, or removed in a 138 checked out CVS tree; also notices unknown files. 139 Contributed by Lowell Skoog <fluke!lowell@uunet.uu.net> 140 141 sccs2rcs A C-shell script that can convert (some) SCCS files 142 into RCS files, retaining the info contained in the 143 SCCS file (like dates, author, and log message). 144 Contributed by Ken Cox <kenstir@viewlogic.com>. 145 146 verify_repo A perl script to check an entire repository for 147 corruption. 148 Contributed by Donald Sharp <sharpd@cisco.com>. 149