contrib/cvs/contrib/README

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