1RCSFREEZE(1)                General Commands Manual               RCSFREEZE(1)
2
3
4

NAME

6       rcsfreeze - freeze a configuration of sources checked in under RCS
7

SYNOPSIS

9       rcsfreeze [name]
10

DESCRIPTION

12       rcsfreeze assigns a symbolic revision number to a set of RCS files that
13       form a valid configuration.
14
15       The idea is to run rcsfreeze each time a new version is checked in.   A
16       unique  symbolic  name  (C_number,  where number is increased each time
17       rcsfreeze is run) is then assigned to the most recent revision of  each
18       RCS file of the main trunk.
19
20       An  optional  name  argument  to rcsfreeze gives a symbolic name to the
21       configuration.  The unique identifier is still generated and is  listed
22       in the log file but it will not appear as part of the symbolic revision
23       name in the actual RCS files.
24
25       A log message is requested from the user for future reference.
26
27       The shell script works only on all RCS files at one time.  All  changed
28       files  must  be  checked  in  already.   Run  rcsclean(1) first and see
29       whether any sources remain in the current directory.
30

FILES

32       RCS/.rcsfreeze.ver
33              version number
34
35       RCS/.rcsfreeze.log
36              log messages, most recent first
37

ENVIRONMENT

39       RCSINIT
40              Options prepended to the argument list, separated by spaces.   A
41              backslash  escapes spaces within an option.  The RCSINIT options
42              are prepended to the argument lists of most RCS commands.   Use‐
43              ful RCSINIT options include -q, -V, -x, and -z.
44
45       RCS_MEM_LIMIT
46              An  integer lim, measured in kilobytes, specifying the threshold
47              under which commands will try to use memory-based operations for
48              processing  the  RCS file.  (For RCS files of size lim kilobytes
49              or greater, RCS will use the slower standard  input/output  rou‐
50              tines.)  Default value is 256.
51
52       TMPDIR Name  of  the  temporary directory.  If not set, the environment
53              variables TMP and TEMP are inspected instead and the first value
54              found  is  taken;  if  none  of  them  are set, a host-dependent
55              default is used, typically /tmp.
56

AUTHOR

58       Stephan v. Bechtolsheim
59

SEE ALSO

61       co(1), rcs(1), rcsclean(1), rlog(1).
62
63       Walter F. Tichy, RCSA System for Version  Control,  SoftwarePractice  &
64       Experience 15, 7 (July 1985), 637-654.
65
66       The  full  documentation for RCS is maintained as a Texinfo manual.  If
67       the info(1) and RCS programs are properly installed at your  site,  the
68       command
69
70              info rcs
71
72       should  give  you access to the complete manual.  Additionally, the RCS
73       homepage:
74
75              http://www.gnu.org/software/rcs/
76
77       has news and links to the latest release, development site, etc.
78

BUGS

80       rcsfreeze does not check whether any sources are checked out and  modi‐
81       fied.
82
83       Although  both  working  and  RCS file names are accepted, they are not
84       paired as usual with RCS commands.
85
86       Error checking is rudimentary.
87
88       rcsfreeze is just an optional example shell script, and should  not  be
89       taken too seriously.  See CVS for a more complete solution.
90
91
92
93GNU RCS 5.9.0                     2014-06-10                      RCSFREEZE(1)