2 .\" Set p to 1 if your formatter can handle pic output.
12 .TH RCSFILE 5 \*(Dt GNU
14 rcsfile \- format of RCS file
17 contents are described by the grammar
20 The text is free format: space, backspace, tab, newline, vertical
21 tab, form feed, and carriage return (collectively,
23 have no significance except in strings.
24 However, white space cannot appear within an id, num, or sym,
25 and an \*r file must end with a newline.
27 Strings are enclosed by
29 If a string contains a
32 otherwise, strings can contain arbitrary binary data.
34 The meta syntax uses the following conventions: `|' (bar) separates
35 alternatives; `{' and `}' enclose optional phrases; `{' and `}*' enclose
36 phrases that can be repeated zero or more times;
37 `{' and '}+' enclose phrases that must appear at least once and can be
39 Terminal symbols are in
41 nonterminal symbols are in
44 .nr w \w'\f3deltatext\fP '
45 .nr y \w'\f3newphrase\fP '
47 .nr x \w'\f3branches\fP'
48 .nr y \w'{ \f3comment\fP'
50 .nr y \w'\f3{ branch\fP'
52 .ta \nwu +\w'::= 'u +\nxu+\w' 'u
55 \f2rcstext\fP ::= \f2admin\fP {\f2delta\fP}* \f2desc\fP {\f2deltatext\fP}*
57 \f2admin\fP ::= \f3head\fP {\f2num\fP}\f3;\fP
58 { \f3branch\fP {\f2num\fP}\f3;\fP }
59 \f3access\fP {\f2id\fP}*\f3;\fP
60 \f3symbols\fP {\f2sym\fP \f3:\fP \f2num\fP}*\f3;\fP
61 \f3locks\fP {\f2id\fP \f3:\fP \f2num\fP}*\f3;\fP {\f3strict ;\fP}
62 { \f3comment\fP {\f2string\fP}\f3;\fP }
63 { \f3expand\fP {\f2string\fP}\f3;\fP }
66 \f2delta\fP ::= \f2num\fP
67 \f3date\fP \f2num\fP\f3;\fP
68 \f3author\fP \f2id\fP\f3;\fP
69 \f3state\fP {\f2id\fP}\f3;\fP
70 \f3branches\fP {\f2num\fP}*\f3;\fP
71 \f3next\fP {\f2num\fP}\f3;\fP
74 \f2desc\fP ::= \f3desc\fP \f2string\fP
76 \f2deltatext\fP ::= \f2num\fP
77 \f3log\fP \f2string\fP
79 \f3text\fP \f2string\fP
81 \f2num\fP ::= {\f2digit\fP | \f3.\fP}+
83 \f2digit\fP ::= \f30\fP | \f31\fP | \f32\fP | \f33\fP | \f34\fP | \f35\fP | \f36\fP | \f37\fP | \f38\fP | \f39\fP
85 \f2id\fP ::= {\f2num\fP} \f2idchar\fP {\f2idchar\fP | \f2num\fP}*
87 \f2sym\fP ::= {\f2digit\fP}* \f2idchar\fP {\f2idchar\fP | \f2digit\fP}*
89 \f2idchar\fP ::= any visible graphic character except \f2special\fP
91 \f2special\fP ::= \f3$\fP | \f3,\fP | \f3.\fP | \f3:\fP | \f3;\fP | \f3@\fP
93 \f2string\fP ::= \f3@\fP{any character, with \f3@\fP doubled}*\f3@\fP
95 \f2newphrase\fP ::= \f2id\fP \f2word\fP* \f3;\fP
97 \f2word\fP ::= \f2id\fP | \f2num\fP | \f2string\fP | \f3:\fP
100 Identifiers are case sensitive. Keywords are in lower case only.
101 The sets of keywords and identifiers can overlap.
102 In most environments \*r uses the \s-1ISO\s0 8859/1 encoding:
103 visible graphic characters are codes 041\-176 and 240\-377,
104 and white space characters are codes 010\-015 and 040.
106 Dates, which appear after the
108 keyword, are of the form
109 \f2Y\fP\f3.\fP\f2mm\fP\f3.\fP\f2dd\fP\f3.\fP\f2hh\fP\f3.\fP\f2mm\fP\f3.\fP\f2ss\fP,
125 contains just the last two digits of the year
126 for years from 1900 through 1999,
127 and all the digits of years thereafter.
128 Dates use the Gregorian calendar; times use UTC.
132 productions in the grammar are reserved for future extensions
133 to the format of \*r files.
136 will begin with any keyword already in use.
140 nodes form a tree. All nodes whose numbers
141 consist of a single pair
142 (e.g., 2.3, 2.1, 1.3, etc.)
143 are on the trunk, and are linked through the
145 field in order of decreasing numbers.
150 node points to the head of that sequence (i.e., contains
154 node in the admin node indicates the default
155 branch (or revision) for most \*r operations.
156 If empty, the default
157 branch is the highest branch on the trunk.
161 nodes whose numbers consist of
165 (e.g., 3.1.1.1, 2.1.2.2, etc.)
166 are linked as follows.
167 All nodes whose first
169 number fields are identical are linked through the
171 field in order of increasing numbers.
172 For each such sequence,
175 node whose number is identical to the first
177 number fields of the deltas on that sequence is called the branchpoint.
180 field of a node contains a list of the
181 numbers of the first nodes of all sequences for which it is a branchpoint.
182 This list is ordered in increasing numbers.
184 The following diagram shows an example of an \*r file's organization.
198 / \ / \ | 2.1 | / \ / \
200 /1.2.1.3\ /1.3.1.1\ | | /1.2.2.2\ /1.2.2.1.1.1\
201 --------- --------- --------- --------- -------------
205 / \ | --------- / \ |
207 / \ ---------\ / / \-----------
208 /1.2.1.1\ \ / /1.2.2.1\
209 --------- \ / ---------
215 ----------------------\ /---------
235 .\" -2.0625 -4.25 1.75 0
236 .\" 0.000i 4.250i 3.812i 0.000i
243 \h'2.062i-(\w'Head'u/2u)'\v'0.125i-(0v/2u)+0v+0.22m'Head
245 \h'2.062i'\v'0.250i'\D'l0.000i 0.500i'
247 \h'2.087i'\v'0.650i'\D'l-0.025i 0.100i'
249 \h'2.062i'\v'0.750i'\D'l-0.025i -0.100i'
251 \h'1.688i'\v'1.250i'\D'l0.750i 0.000i'
253 \h'2.438i'\v'1.250i'\D'l0.000i -0.500i'
255 \h'2.438i'\v'0.750i'\D'l-0.750i 0.000i'
257 \h'1.688i'\v'0.750i'\D'l0.000i 0.500i'
260 \h'2.062i-(\w'2.1'u/2u)'\v'1.000i-(0v/2u)+0v+0.22m'2.1
262 \h'2.062i'\v'1.250i'\D'l0.000i 0.500i'
264 \h'2.087i'\v'1.650i'\D'l-0.025i 0.100i'
266 \h'2.062i'\v'1.750i'\D'l-0.025i -0.100i'
269 \h'2.062i-(\w'1.3'u/2u)'\v'2.000i-(1v/2u)+0v+0.22m'1.3
271 \h'2.062i'\v'2.250i'\D'l-0.375i -0.500i'
273 \h'1.688i'\v'1.750i'\D'l0.750i 0.000i'
275 \h'2.438i'\v'1.750i'\D'l-0.375i 0.500i'
277 \h'1.875i'\v'2.000i'\D'~-0.500i 0.000i 0.000i -0.500i'
279 \h'1.350i'\v'1.600i'\D'l0.025i -0.100i'
281 \h'1.375i'\v'1.500i'\D'l0.025i 0.100i'
284 \h'1.375i-(\w'1.3.1.1'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.3.1.1
286 \h'1.375i'\v'1.000i'\D'l-0.375i 0.500i'
288 \h'1.000i'\v'1.500i'\D'l0.750i 0.000i'
290 \h'1.750i'\v'1.500i'\D'l-0.375i -0.500i'
292 \h'2.062i'\v'2.250i'\D'l0.000i 0.500i'
294 \h'2.087i'\v'2.650i'\D'l-0.025i 0.100i'
296 \h'2.062i'\v'2.750i'\D'l-0.025i -0.100i'
299 \h'2.062i-(\w'1.2'u/2u)'\v'3.000i-(1v/2u)+0v+0.22m'1.2
301 \h'2.062i'\v'3.250i'\D'l-0.375i -0.500i'
303 \h'1.688i'\v'2.750i'\D'l0.750i 0.000i'
305 \h'2.438i'\v'2.750i'\D'l-0.375i 0.500i'
307 \h'1.875i'\v'3.000i'\D'~-0.500i 0.000i -0.500i 0.000i -0.500i 0.000i 0.000i -0.500i'
309 \h'0.350i'\v'2.600i'\D'l0.025i -0.100i'
311 \h'0.375i'\v'2.500i'\D'l0.025i 0.100i'
314 \h'0.375i-(\w'1.2.1.1'u/2u)'\v'2.250i-(1v/2u)+1v+0.22m'1.2.1.1
316 \h'0.375i'\v'2.000i'\D'l-0.375i 0.500i'
318 \h'0.000i'\v'2.500i'\D'l0.750i 0.000i'
320 \h'0.750i'\v'2.500i'\D'l-0.375i -0.500i'
322 \h'0.375i'\v'2.000i'\D'l0.000i -0.500i'
324 \h'0.350i'\v'1.600i'\D'l0.025i -0.100i'
326 \h'0.375i'\v'1.500i'\D'l0.025i 0.100i'
329 \h'0.375i-(\w'1.2.1.3'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.2.1.3
331 \h'0.375i'\v'1.000i'\D'l-0.375i 0.500i'
333 \h'0.000i'\v'1.500i'\D'l0.750i 0.000i'
335 \h'0.750i'\v'1.500i'\D'l-0.375i -0.500i'
337 \h'2.250i'\v'3.000i'\D'~0.500i 0.000i 0.000i -0.500i'
339 \h'2.725i'\v'2.600i'\D'l0.025i -0.100i'
341 \h'2.750i'\v'2.500i'\D'l0.025i 0.100i'
344 \h'2.750i-(\w'1.2.2.1'u/2u)'\v'2.250i-(1v/2u)+1v+0.22m'1.2.2.1
346 \h'2.750i'\v'2.000i'\D'l-0.375i 0.500i'
348 \h'2.375i'\v'2.500i'\D'l0.750i 0.000i'
350 \h'3.125i'\v'2.500i'\D'l-0.375i -0.500i'
352 \h'2.938i'\v'2.250i'\D'~0.500i 0.000i 0.000i -0.500i 0.000i -0.500i'
354 \h'3.413i'\v'1.350i'\D'l0.025i -0.100i'
356 \h'3.438i'\v'1.250i'\D'l0.025i 0.100i'
359 \h'3.438i-(\w'\s-21.2.2.1.1.1\s0'u/2u)'\v'1.000i-(1v/2u)+1v+0.22m'\s-21.2.2.1.1.1\s0
361 \h'3.438i'\v'0.750i'\D'l-0.375i 0.500i'
363 \h'3.062i'\v'1.250i'\D'l0.750i 0.000i'
365 \h'3.812i'\v'1.250i'\D'l-0.375i -0.500i'
367 \h'2.750i'\v'2.000i'\D'l0.000i -0.500i'
369 \h'2.725i'\v'1.600i'\D'l0.025i -0.100i'
371 \h'2.750i'\v'1.500i'\D'l0.025i 0.100i'
374 \h'2.750i-(\w'1.2.2.2'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.2.2.2
376 \h'2.750i'\v'1.000i'\D'l-0.375i 0.500i'
378 \h'2.375i'\v'1.500i'\D'l0.750i 0.000i'
380 \h'3.125i'\v'1.500i'\D'l-0.375i -0.500i'
382 \h'2.062i'\v'3.250i'\D'l0.000i 0.500i'
384 \h'2.087i'\v'3.650i'\D'l-0.025i 0.100i'
386 \h'2.062i'\v'3.750i'\D'l-0.025i -0.100i'
389 \h'2.062i-(\w'1.1'u/2u)'\v'4.000i-(1v/2u)+0v+0.22m'1.1
391 \h'2.062i'\v'4.250i'\D'l-0.375i -0.500i'
393 \h'1.688i'\v'3.750i'\D'l0.750i 0.000i'
395 \h'2.438i'\v'3.750i'\D'l-0.375i 0.500i'
409 Author: Walter F. Tichy,
410 Purdue University, West Lafayette, IN, 47907.
412 Manual Page Revision: \*(Rv; Release Date: \*(Dt.
414 Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
416 Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.
418 rcsintro(1), ci(1), co(1), ident(1), rcs(1), rcsclean(1), rcsdiff(1),
422 \*r\*-A System for Version Control,
423 .I "Software\*-Practice & Experience"
425 7 (July 1985), 637-654.