Provided by: lmbench-doc_3.0-a9-1.1_all bug


       rccs - apply RCS commands to sets of files


       rccs command [ options ] [ filename and/or directory ...  ]


       rccs  is  a  perl script that tries to emulate the Berkeley SCCS program for RCS.  If your
       fingers know how to type commands to SCCS, just do the same thing to rccs.

       A subset of the SCCS commands are implemented, the ones that I  use.   Some  new  commands
       have  been  added.  It is easy to add more commands, see the Example routine at the bottom
       of rccs to see how.

       This interface does not require a list of files/directories for most commands; the implied
       list is *,v and/or RCS/*,v.  Destructive commands, such as clean -f, unedit, unget, do not
       have an implied list.  In other words, rccs diffs is the same as rccs diffs RCS  but  rccs
       unedit is not the same as rccs unedit RCS.


       options Note  that RCS options are typically passed through to RCS.  The options that made
               sense to SCCS commands are translated to RCS options.

       ci        Alias for delta.  Checks in files.

       clean [-e] [-f] [-d|y'message'] [files]
                 Without any arguments, this command removes all files that  are  read  only  and
                 have  an  associated  RCS  file.  With the -e argument, clean removes files that
                 have been checked out writable but have not been modified.   The  -d|y|m  option
                 may  be  combined  with -e to check in the set of files that have been modified.
                 With the -f option, clean removes all working files, including files  that  have
                 been modified since the check out.  Be careful.

       co        Alias for get.  Checks out files.

       create [-y|d'message'] [-g] files
                 Initial  check  in  of  files to the RCS system.  The files are then checked out
                 readonly unless the -g option is present.  The -y or -d options may be  used  to
                 set  the descriptive text message.  Differs from SCCS in that the original files
                 are not preserved.

       deledit   Alias for delta followed by a get -e.

       delget    Alias for delta followed by a get.

       delta [-y|d'message'] [-q] [files]
                 Check in a delta of the file.  -q is changed to RCS' -s and means  to  be  quiet
                 about hwat is happening.  -y'message' or -d'message' or -m'message' all get sent
                 through to RCS as the check in message.  No other arguments are translated.

       diffs [-C|c] [-r<rev>] [-sdiff] [files]
                 Shows changes between the working files and the RCS file.  Note that  the  files
                 do not need to be checked out, only writable.  -C or -c means do a context diff.
                 -sdiff means do a side by side diff.  The sdiff  option  will  figure  out  your
                 screen width if it knows how - see the source to make this work on your system.

       edit      Alias for get -e.

       enter     Alias for create -g.

       fix       Useful  if  you just checked in the file and then realized you forgot something.
                 The fix command will remove the top delta from the history and leave you with an
                 editable working file with the top delta as the contents.

       get [-e] [-p] [-k] [-s] [files]
                 Get,  or  check  out,  the  file.  Without any options, get just gets the latest
                 revision of the RCS file in the working file.   With  -e,  check  out  the  file
                 writable.   With -p, send the file to stdout.  With -k, supress expansion of key
                 words.  With -s, be quiet about what is happening.

       help      Get a brief help screen of information.

       history [files]
                 Print the RCS history (my format) of the specified files.

       info [files]
                 Print the list of files being edited.

       print     Alias for a loop that prints the history of each file followed by  the  contents
                 of the file.

       prs       Alias for history.

       prt       Alias for history.

       unedit    Alias for clean -f.

       unget     Alias for clean -f.


       -debug    Turn on debugging.  Used when debugging rccs itself.

       -verbose  Be more verbose about what is happening.


       To  start  off,  add  a  bunch  of  files to RCS: rccs create -y'my program name' myprog.c
       myprog.h Now let's edit them all: rccs get -e If we didn't change anything, the  following
       gives us a clean directory: rccs clean -e If we changed myprog.h, the following gives us a
       clean directory after checking in myprog.h: rccs clean -e -d'some message' If we  want  to
       see what we changed: rccs diffs


       RCS commands, SCCS commands, sdiff(1), perl(1).


       It would be nice to implement a -i option that prompted before each action, especially the
       destructive ones.