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              Normally,  for  speed,  commands  either memory map or copy into
47              memory the RCS file if its size is less than  the  memory-limit,
48              currently  defaulting  to  ``unlimited''.   Otherwise (or if the
49              initially-tried speedy ways fail), the commands fall back to us‐
50              ing  standard  i/o routines.  You can adjust the memory limit by
51              setting RCS_MEM_LIMIT to a numeric value lim (measured in  kilo‐
52              bytes).   An empty value is silently ignored.  As a side effect,
53              specifying RCS_MEM_LIMIT inhibits fall-back to slower routines.
54
55       TMPDIR Name of the temporary directory.  If not  set,  the  environment
56              variables TMP and TEMP are inspected instead and the first value
57              found is taken; if none of them are set,  a  host-dependent  de‐
58              fault is used, typically /tmp.
59

AUTHOR

61       Stephan v. Bechtolsheim
62

SEE ALSO

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

BUGS

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