projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| acec9572 WJ |
1 | .TH RCSFREEZE 1L "" "Purdue University" |
| 2 | .SH NAME | |
| 3 | rcsfreeze \- freeze a configuration of sources checked in under RCS | |
| 4 | .SH SYNOPSIS | |
| 5 | .B rcsfreeze | |
| 6 | [symbolic revision name] | |
| 7 | .SH DESCRIPTION | |
| 8 | The | |
| 9 | .I rcsfreeze | |
| 10 | command has the purpose of assigning a symbolic revision | |
| 11 | number to a set of RCS files, which form a valid configuration. | |
| 12 | .PP | |
| 13 | The idea is to run | |
| 14 | .I rcsfreeze | |
| 15 | each time a new version is checked | |
| 16 | in. A unique symbolic revision number (\c | |
| 17 | .BI C_ number, | |
| 18 | where | |
| 19 | .I number | |
| 20 | is increased each time rcsfreeze is run) is then assigned to the most | |
| 21 | recent revision of each RCS file of the main trunk. | |
| 22 | .PP | |
| 23 | If the command is invoked with an argument, then this | |
| 24 | argument is used as the symbolic name to freeze a configuration. | |
| 25 | The unique identifier is still generated | |
| 26 | and is listed in the log file but it will not appear as | |
| 27 | part of the symbolic revision name in the actual RCS files. | |
| 28 | .PP | |
| 29 | A log message is requested from the user which is saved for future | |
| 30 | references. | |
| 31 | .PP | |
| 32 | The shell script works only on all RCS files at one time. | |
| 33 | It is important that all changed files are checked in (there are | |
| 34 | no precautions against any error in this respect). Run | |
| 35 | .IR rcsclean (1L) | |
| 36 | first and see whether any sources remain in the current directory. | |
| 37 | .SH FILES | |
| 38 | .TP 2.5i | |
| 39 | [RCS/]rcsfreeze.version | |
| 40 | for the version number | |
| 41 | .TP | |
| 42 | [RCS/]rscfreeze.log | |
| 43 | for the log messages, most recent log message first. | |
| 44 | .SH AUTHOR | |
| 45 | Stephan v. Bechtolsheim | |
| 46 | .SH "SEE ALSO" | |
| 47 | rcs(1L), rlog(1L), rcsclean(1L) | |
| 48 | .SH BUGS | |
| 49 | The program does not check whether there are any sources checked out | |
| 50 | and modified. |