.. d $FreeBSD: src/gnu/usr.bin/rcs/rcsfreeze/rcsfreeze.1,v 1.5 1999/08/27 23:36:57 peter Exp $ d $DragonFly: src/gnu/usr.bin/rcs/rcsfreeze/rcsfreeze.1,v 1.2 2003/06/17 04:25:48 dillon Exp $
RCSFREEZE 1 \*(Dt GNU
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 \*r files that form a valid configuration.

The idea is to run rcsfreeze each time a new version is checked in. A unique symbolic name (\c C_ number, where number is increased each time rcsfreeze is run) is then assigned to the most recent revision of each \*r 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 \*r files.

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

The shell script works only on all \*r 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 \s-1CVS\s0 for a more complete solution.