![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rcsfile.5 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / rcs / man|
Return to rcsfile.5 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / rcs / man |
1.1 ! root 1: .TH RCSFILE 5L "" "Purdue University" ! 2: .SH NAME ! 3: rcsfile \- format of RCS file ! 4: .SH DESCRIPTION ! 5: An RCS file is an ASCII file. Its contents are described by the grammar ! 6: below. The text is free format, i.e., spaces, tabs and new lines have ! 7: no significance except in strings. Strings are enclosed by `@'. ! 8: If a string contains a `@', it must be doubled. ! 9: .PP ! 10: The meta syntax uses the following conventions: `|' (bar) separates ! 11: alternatives; `{' and `}' enclose optional phrases; `{' and `}*' enclose ! 12: phrases that may be repeated zero or more times; ! 13: `{' and '}+' enclose phrases that must appear at least once and may be ! 14: repeated; ! 15: `<' and `>' enclose nonterminals. ! 16: .PP ! 17: .ta 1.5i 2.0i 3i ! 18: .fc ~ ! 19: .nf ! 20: ! 21: ! 22: <rcstext> ~~::=~~<admin> {<delta>}* <desc> {<deltatext>}* ! 23: ! 24: <admin> ~~::=~~\fBhead\fR ~~{<num>}; ! 25: ~~ ~~\fBbranch\fR ~~{<num>}; ! 26: ~~ ~~\fBaccess\fR ~~{<id>}*; ! 27: ~~ ~~\fBsymbols\fR ~~{<id> : <num>}*; ! 28: ~~ ~~\fBlocks\fR ~~{<id> : <num>}*; ! 29: ~~ ~~\fBcomment\fR ~~{<string>}; ! 30: ! 31: <delta> ~~::=~~<num> ! 32: ~~ ~~\fBdate\fR ~~<num>; ! 33: ~~ ~~\fBauthor\fR ~~<id>; ! 34: ~~ ~~\fBstate\fR ~~{<id>}; ! 35: ~~ ~~\fBbranches\fR ~~{<num>}*; ! 36: ~~ ~~\fBnext\fR ~~{<num>}; ! 37: ! 38: <desc> ~~::=~~\fBdesc\fR ~~<string> ! 39: ! 40: <deltatext>~~::=~~<num> ! 41: ~~ ~~\fBlog\fR ~~<string> ! 42: ~~ ~~\fBtext\fR ~~<string> ! 43: ! 44: ! 45: <num> ~~::=~~{<digit>{.}}+ ! 46: ! 47: <digit> ~~::=~~0 | 1 | ... | 9 ! 48: ! 49: <id> ~~::=~~<letter>{<idchar>}* ! 50: ! 51: <letter> ~~::=~~A | B | ... | Z | a | b | ... | z ! 52: ! 53: <idchar> ~~::=~~Any printing ASCII character except space, ! 54: ~~ ~~tab, carriage return, new line, and <special>. ! 55: ! 56: <special> ~~::=~~; | : | , | @ ! 57: ! 58: <string> ~~::=~~@{any ASCII character, with `@' doubled}*@ ! 59: ! 60: .fi ! 61: .PP ! 62: Identifiers are case sensitive. Keywords are in lower case only. ! 63: The sets of keywords and identifiers may overlap. ! 64: .PP ! 65: The <delta> nodes form a tree. All nodes whose numbers ! 66: consist of a single pair ! 67: (e.g., 2.3, 2.1, 1.3, etc.) ! 68: are on the "trunk", and are linked through the \fBnext\fR ! 69: field in order of decreasing numbers. The \fBhead\fR field in the ! 70: <admin> node points to the head of that sequence (i.e., contains ! 71: the highest pair). ! 72: The \fBbranch\fR node in the admin node indicates the default ! 73: branch (or revision) for most RCS operations. If empty, the default ! 74: branch is the highest branch on the trunk. ! 75: .PP ! 76: All <delta> nodes whose numbers consist of 2n fields (n\(>=2) ! 77: (e.g., 3.1.1.1, 2.1.2.2, etc.) ! 78: are linked as follows. All nodes whose first (2n)-1 number fields are identical ! 79: are linked through the \fBnext\fR field in order of increasing numbers. ! 80: For each such sequence, ! 81: the <delta> node whose number is identical to the first ! 82: 2(n-1) number fields of the deltas on that sequence is called the branchpoint. ! 83: The \fBbranches\fR field of a node contains a list of the ! 84: numbers of the first nodes of all sequences for which it is a branchpoint. ! 85: This list is ordered in increasing numbers. ! 86: .sp 1 ! 87: .ne 38 ! 88: Example: ! 89: .eo ! 90: .nf ! 91: .vs 12pts ! 92: .cs 1 20 ! 93: .if t .in +0.5i ! 94: Head ! 95: | ! 96: | ! 97: v ! 98: --------- ! 99: / \ / \ | | / \ / \ ! 100: / \ / \ | 2.1 | / \ / \ ! 101: / \ / \ | | / \ / \ ! 102: /1.2.1.3\ /1.3.1.1\ | | /1.2.2.2\ /1.2.2.1.1.1\ ! 103: --------- --------- --------- --------- ------------- ! 104: ^ ^ | ^ ^ ! 105: | | | | | ! 106: | | v | | ! 107: / \ | --------- / \ | ! 108: / \ | \ 1.3 / / \ | ! 109: / \ ---------\ / / \----------- ! 110: /1.2.1.1\ \ / /1.2.2.1\ ! 111: --------- \ / --------- ! 112: ^ | ^ ! 113: | | | ! 114: | v | ! 115: | --------- | ! 116: | \ 1.2 / | ! 117: ----------------------\ /--------- ! 118: \ / ! 119: \ / ! 120: | ! 121: | ! 122: v ! 123: --------- ! 124: \ 1.1 / ! 125: \ / ! 126: \ / ! 127: \ / ! 128: ! 129: ! 130: .if t .in -0.5i ! 131: .cs 1 ! 132: .ec ! 133: .ce ! 134: Fig. 1: A revision tree ! 135: .fi ! 136: .PP ! 137: .SH IDENTIFICATION ! 138: .de VL ! 139: \\$2 ! 140: .. ! 141: Author: Walter F. Tichy, ! 142: Purdue University, West Lafayette, IN, 47907. ! 143: .sp 0 ! 144: Revision Number: ! 145: .VL $Revision: 1.1 $ ! 146: ; Release Date: ! 147: .VL $Date: 87/03/11 21:30:02 $ ! 148: \&. ! 149: .sp 0 ! 150: Copyright \(co 1982 by Walter F. Tichy. ! 151: .SH SEE ALSO ! 152: ci(1L), co(1L), ident(1L), rcs(1L), rcsdiff(1L), rcsmerge(1L), rlog(1L), ! 153: .br ! 154: Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control ! 155: System," in \fIProceedings of the 6th International Conference on Software ! 156: Engineering\fR, IEEE, Tokyo, Sept. 1982.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.