rcsfile.4 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

rcsﬁle(4) rcsﬁle(4)

NAME

rcsﬁle - format of RCS ﬁles

DESCRIPTION

An RCS ﬁle is an ASCII ﬁle. Its contents are described by the grammar below. The text is free format,

that is, spaces, tabs and newline characters have no signiﬁcance except in strings. Strings are enclosed

@ symbols. If a string contains the

@ symbol, the symbol must be doubled.

The meta syntax uses the following conventions:

| (bar) Separates alternatives.

{...} (braces) Enclose optional phrases.

Enclose phrases that may be repeated zero

or more times.

{...}* (braces star)

Enclose phrases that must appear at least

once and may be repeated.

{...}+ (braces plus)

<...> (angle brackets) Enclose nonterminals.

RCS File Grammar

Identiﬁers are case sensitive. Keywords are in lowercase only. The sets of keywords and identiﬁers may

overlap.

<rcstext> ::= <admin> {<delta>}* <desc> {<deltatext>}*

<admin> ::= head {<num>};

access {<id>}*;

symbols {<id> : <num>}*;

locks {<id> : <num>}*; {strict ;}

comment {<string>};

date <num>;

author <id>;

state {<id>};

branches {<num>}*;

next {<num>};

log <string>

text <string>

<num> ::= {<digit>{.}}+

<digit> ::= 0|1|...|9

<id> ::= <letter>{<idchar>}*

<letter> ::= A|B|...|Z|a|b|...|z

<idchar> ::= Any printing ASCII character except space,

tab, carriage return, newline, and <special>.

<special> ::= ;|:|,|@

<string> ::= @{any ASCII character, with "@" doubled}*@

RCS File Structure

The

<delta> nodes form a tree. All nodes whose numbers consist of a single pair (for example, 2.3, 2.1,

1.3, etc.) are on the trunk, and are linked through the next ﬁeld in order of decreasing numbers. The

head ﬁeld in the <admin> node points to the head of that sequence (that is, contains the highest pair).

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
rcsfile(4) rcsfile(4) NAME rcsfile - format of RCS files DESCRIPTION An RCS file is an ASCII file. Its contents are described by the grammar below. The text is free format, that is, spaces, tabs and newline characters have no significance except in strings. Strings are enclosed by @ symbols. If a string contains the @ symbol, the symbol must be doubled. The meta syntax uses the following conventions: | {...} {...}* (bar) (braces) (braces star) {...}+ (braces plus) <...
PAGE 2
rcsfile(4) rcsfile(4) All nodes whose numbers consist of 2n fields (n>=2) (for example, 3.1.1.1, 2.1.2.2, etc.) are linked as follows. All nodes whose first (2n)-1 number fields are identical are linked through the next field in order of increasing numbers. For each such sequence, the node whose number is identical to the first 2(n-1) number fields of the deltas on that sequence is called the branchpoint.