contrib/cvs-1.12.9/contrib/README

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