rcsfreeze(1)                   DG/UX R4.11MU05                  rcsfreeze(1)


NAME
       rcsfreeze - freeze a configuration of sources checked in under RCS

SYNOPSIS
       rcsfreeze [name]

DESCRIPTION
       rcsfreeze assigns a symbolic revision number to a set of RCS files
       that form a valid configuration.

       The idea is to run rcsfreeze each time a new version is checked in.
       A unique symbolic name (Cnumber, where number is increased each time
       rcsfreeze is run) is then assigned to the most recent revision of
       each RCS file of the main trunk.

       An optional name argument to rcsfreeze gives a symbolic name to the
       configuration.  The unique identifier is still generated and is
       listed in the log file but it will not appear as part of the symbolic
       revision name in the actual RCS files.

       A log message is requested from the user for future reference.

       The shell script works only on all RCS files at one time.  All
       changed files must be checked in already.  Run rcsclean(1) first and
       see whether any sources remain in the current directory.

FILES
       RCS/.rcsfreeze.ver
              version number

       RCS/.rcsfreeze.log
              log messages, most recent first

AUTHOR
       Stephan v. Bechtolsheim

SEE ALSO
       co(1), rcs(1), rcsclean(1), rlog(1).

BUGS
       rcsfreeze does not check whether any sources are checked out and
       modified.

       Although both source file names and RCS file names are accepted, they
       are not paired as usual with RCS commands.

       Error checking is rudimentary.

       rcsfreeze is just an optional example shell script, and should not be
       taken too seriously.  See CVS for a more complete solution.  Also in
       case you want some ideas on how to use RCS tools in a shell script,
       here is the source for rcsfreeze.

       #! /bin/sh
       # rcsfreeze - assign symbolic rev. number to a configuration of RCS files
       #  rcsfreeze.1,v 6.16.1.1 1997/10/18 08:36:24 sacadm Exp

       #  The idea is to run rcsfreeze each time a new version is checked
       #  in. A unique symbolic revision number (C[number], where number
       #  is increased each time rcsfreeze is run) is then assigned to the most
       #  recent revision of each RCS file of the main trunk.
       #
       #  If the command is invoked with an argument, then this
       #  argument is used as the symbolic name to freeze a configuration.
       #  The unique identifier is still generated
       #  and is listed in the log file but it will not appear as
       #  part of the symbolic revision name in the actual RCS file.
       #
       #  A log message is requested from the user which is saved for future
       #  references.
       #
       #  The shell script works only on all RCS files at one time.
       #  It is important that all changed files are checked in (there are
       #  no precautions against any error in this respect).
       #  file names:
       #  {RCS/}.rcsfreeze.ver    version number
       #  {RCS/}.rcsfreeze.log    log messages, most recent first

       PATH=/usr/local/bin:/bin:/usr/bin:/usr/ucb:$PATH
       export PATH

       DATE=`date` || exit
       # Check whether we have an RCS subdirectory, so we can have the right
       # prefix for our paths.
       if [ -d RCS ]
       then RCSDIR=RCS/
       else RCSDIR=
       fi

       # Version number stuff, log message file
       VERSIONFILE=${RCSDIR}.rcsfreeze.ver
       LOGFILE=${RCSDIR}.rcsfreeze.log
       # Initialize, rcsfreeze never run before in the current directory
       [ -r $VERSIONFILE ] || { echo 0 >$VERSIONFILE && >>$LOGFILE; } || exit

       # Get Version number, increase it, write back to file.
       VERSIONNUMBER=`cat $VERSIONFILE` &&
       VERSIONNUMBER=`expr $VERSIONNUMBER + 1` &&
       echo $VERSIONNUMBER >$VERSIONFILE || exit

       # Symbolic Revision Number
       SYMREV=C$VERSIONNUMBER
       # Allow the user to give a meaningful symbolic name to the revision.
       SYMREVNAME=${1-$SYMREV}
       echo >&2 "rcsfreeze: symbolic revision number computed: \"$SYMREV\"
       rcsfreeze: symbolic revision number used:     \"$SYMREVNAME\"
       rcsfreeze: the two differ only when rcsfreeze invoked with argument
       rcsfreeze: give log message, summarizing changes (end with EOF or \
       single '.')" || exit

       # Stamp the logfile. Because we order the logfile the most recent
       # first we will have to save everything right now in a temporary file.
       TMPLOG=/tmp/rcsfrz$$
       trap 'rm -f $TMPLOG; exit 1' 1 2 13 15
       # Now ask for a log message, continuously add to the log file
       (
           echo "Version: $SYMREVNAME($SYMREV), Date: $DATE
       -----------" || exit
           while read MESS
           do
               case $MESS in
               .) break
               esac
               echo "    $MESS" || exit
           done
           echo "-----------
       " &&
           cat $LOGFILE
       ) >$TMPLOG &&

       # combine old and new logfiles
       cp $TMPLOG $LOGFILE &&
       rm -f $TMPLOG || exit
       trap 1 2 13 15

       # Now the real work begins by assigning a symbolic revision number
       # to each rcs file. Take the most recent version of the main trunk.

       status=

       for FILE in ${RCSDIR}*
       do
       #   get the revision number of the most recent revision
           HEAD=`rlog -h $FILE` &&
           REV=`echo "$HEAD" | sed -n 's/^head:[     ]*//p'` &&
       #   assign symbolic name to it.
           echo >&2 "rcsfreeze: $REV $FILE" &&
           rcs -q -n$SYMREVNAME:$REV $FILE || status=$?
       done
       exit $status


Licensed material--property of copyright holder(s)