19Sjkh.de Id
29Sjkh.ds Rv \\$3
39Sjkh.ds Dt \\$4
49Sjkh..
550472Speter.Id $FreeBSD: releng/11.0/gnu/usr.bin/rcs/rcsfreeze/rcsfreeze.1 50472 1999-08-27 23:37:10Z peter $
69Sjkh.ds r \s-1RCS\s0
79Sjkh.TH RCSFREEZE 1 \*(Dt GNU
89Sjkh.SH NAME
99Sjkhrcsfreeze \- freeze a configuration of sources checked in under RCS
109Sjkh.SH SYNOPSIS
119Sjkh.B rcsfreeze
129Sjkh.RI [ "name" ]
139Sjkh.SH DESCRIPTION
149Sjkh.B rcsfreeze
159Sjkhassigns a symbolic revision
169Sjkhnumber to a set of \*r files that form a valid configuration.
179Sjkh.PP
189SjkhThe idea is to run
199Sjkh.B rcsfreeze
209Sjkheach time a new version is checked
219Sjkhin.  A unique symbolic name (\c
229Sjkh.BI C_ number,
239Sjkhwhere
249Sjkh.I number
259Sjkhis increased each time
269Sjkh.B rcsfreeze
279Sjkhis run) is then assigned to the most
289Sjkhrecent revision of each \*r file of the main trunk.
299Sjkh.PP
309SjkhAn optional
319Sjkh.I name
329Sjkhargument to
339Sjkh.B rcsfreeze
349Sjkhgives a symbolic name to the configuration.
359SjkhThe unique identifier is still generated
369Sjkhand is listed in the log file but it will not appear as
379Sjkhpart of the symbolic revision name in the actual \*r files.
389Sjkh.PP
399SjkhA log message is requested from the user for future reference.
409Sjkh.PP
419SjkhThe shell script works only on all \*r files at one time.
429SjkhAll changed files must be checked in already.
439SjkhRun
449Sjkh.IR rcsclean (1)
459Sjkhfirst and see whether any sources remain in the current directory.
469Sjkh.SH FILES
479Sjkh.TP
489Sjkh.B RCS/.rcsfreeze.ver
499Sjkhversion number
509Sjkh.TP
519Sjkh.B RCS/.rcsfreeze.log
529Sjkhlog messages, most recent first
539Sjkh.SH AUTHOR
549SjkhStephan v. Bechtolsheim
559Sjkh.SH "SEE ALSO"
569Sjkhco(1), rcs(1), rcsclean(1), rlog(1)
579Sjkh.SH BUGS
589Sjkh.B rcsfreeze
599Sjkhdoes not check whether any sources are checked out and modified.
609Sjkh.PP
619SjkhAlthough both source file names and RCS file names are accepted,
629Sjkhthey are not paired as usual with RCS commands.
639Sjkh.PP
649SjkhError checking is rudimentary.
659Sjkh.PP
669Sjkh.B rcsfreeze
679Sjkhis just an optional example shell script, and should not be taken too seriously.
689SjkhSee \s-1CVS\s0 for a more complete solution.
69