home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / rcs / rcsfreez.man < prev    next >
Text File  |  1992-02-19  |  2KB  |  56 lines
  1. NAME
  2.      rcsfreeze - freeze a configuration of sources checked in
  3.      under RCS
  4.  
  5. SYNOPSIS
  6.      rcsfreeze [name]
  7.  
  8. DESCRIPTION
  9.      rcsfreeze assigns a symbolic revision number to a set of RCS
  10.      files that form a valid configuration.
  11.  
  12.      The idea is to run rcsfreeze each time a new version is
  13.      checked in.  A unique symbolic name (C_number, where number
  14.      is increased each time rcsfreeze is run) is then assigned to
  15.      the most recent revision of each RCS file of the main trunk.
  16.  
  17.      An optional name argument to rcsfreeze gives a symbolic name
  18.      to the configuration.  The unique identifier is still
  19.      generated and is listed in the log file but it will not
  20.      appear as part of the symbolic revision name in the actual
  21.      RCS files.
  22.  
  23.      A log message is requested from the user for future
  24.      reference.
  25.  
  26.      The shell script works only on all RCS files at one time.
  27.      All changed files must be checked in already.  Run
  28.      rcsclean(1) first and see whether any sources remain in the
  29.      current directory.
  30.  
  31. FILES
  32.      RCS/.rcsfreeze.ver
  33.           version number
  34.  
  35.      RCS/.rcsfreeze.log
  36.           log messages, most recent first
  37.  
  38. AUTHOR
  39.      Stephan v. Bechtolsheim
  40.  
  41. SEE ALSO
  42.      co(1), rcs(1), rcsclean(1), rlog(1)
  43.  
  44. BUGS
  45.      rcsfreeze does not check whether any sources are checked out
  46.      and modified.
  47.  
  48.      Although both source file names and RCS file names are
  49.      accepted, they are not paired as usual with RCS commands.
  50.  
  51.      Error checking is rudimentary.
  52.  
  53.      rcsfreeze is just an optional example shell script, and
  54.      should not be taken too seriously.  See CVS for a more
  55.      complete solution.
  56.