From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/debian-unstable/man5/rcsfile.5 | 457 ++++++++++++++++++++++++++++++++ 1 file changed, 457 insertions(+) create mode 100644 upstream/debian-unstable/man5/rcsfile.5 (limited to 'upstream/debian-unstable/man5/rcsfile.5') diff --git a/upstream/debian-unstable/man5/rcsfile.5 b/upstream/debian-unstable/man5/rcsfile.5 new file mode 100644 index 00000000..e33ce395 --- /dev/null +++ b/upstream/debian-unstable/man5/rcsfile.5 @@ -0,0 +1,457 @@ +.if !dPS .ds PS +.if !dPE .ds PE +.ds Rv 5.10.1 +.ds Dt 2022-02-19 +.ds i \&\s-1ISO\s0 +.ds r \&\s-1RCS\s0 +.ds u \&\s-1UTC\s0 +.ds o \*r file +.\" Set p to 1 if your formatter can handle pic output. +.if t .nr p 1 +.if n .ds - \%-- +.if t .ds - \(em +.TH RCSFILE 5 "\*(Dt" "GNU RCS \*(Rv" +.SH NAME +rcsfile \- \*o format +.SH DESCRIPTION +An \*o's +contents are described by the grammar +below. +.PP +The text is free format: space, backspace, tab, newline, vertical +tab, form feed, and carriage return (collectively, +.IR "white space") +have no significance except in strings. +However, white space cannot appear within an id, num, or sym, +and an \*o must end with a newline. +.PP +Strings are enclosed by +.BR @ . +If a string contains a +.BR @ , +it must be doubled; +otherwise, strings can contain arbitrary binary data. +.PP +The meta syntax uses the following conventions: `|' (bar) separates +alternatives; `{' and `}' enclose optional phrases; `{' and `}*' enclose +phrases that can be repeated zero or more times; +`{' and '}+' enclose phrases that must appear at least once and can be +repeated; +Terminal symbols are in +.BR boldface ; +nonterminal symbols are in +.IR italics . +.LP +.nr w \w'\f3deltatext\fP ' +.if \nw<\ny .nr w \ny +.nr x \w'\f3branches\fP' +.nr y \w'{ \f3comment\fP' +.if \nx<\ny .nr x \ny +.nr y \w'\f3{ branch\fP' +.if \nx<\ny .nr x \ny +.ta \nwu +\w'::= 'u +\nxu+\w' 'u +.fc # +.nf +\f2rcstext\fP ::= \f2admin\fP {\f2delta\fP}* \f2desc\fP {\f2deltatext\fP}* +.LP +\f2admin\fP ::= \f3head\fP {\f2num\fP}\f3;\fP + { \f3branch\fP {\f2num\fP}\f3;\fP } + \f3access\fP {\f2id\fP}*\f3;\fP + \f3symbols\fP {\f2sym\fP \f3:\fP \f2num\fP}*\f3;\fP + \f3locks\fP {\f2id\fP \f3:\fP \f2num\fP}*\f3;\fP {\f3strict ;\fP} + { \f3integrity\fP {\f2intstring\fP}\f3;\fP } + { \f3comment\fP {\f2string\fP}\f3;\fP } + { \f3expand\fP {\f2string\fP}\f3;\fP } +.LP +\f2delta\fP ::= \f2num\fP + \f3date\fP \f2num\fP\f3;\fP + \f3author\fP \f2id\fP\f3;\fP + \f3state\fP {\f2id\fP}\f3;\fP + \f3branches\fP {\f2num\fP}*\f3;\fP + \f3next\fP {\f2num\fP}\f3;\fP + { \f3commitid\fP \f2sym\fP\f3;\fP } +.LP +\f2desc\fP ::= \f3desc\fP \f2string\fP +.LP +\f2deltatext\fP ::= \f2num\fP + \f3log\fP \f2string\fP + \f3text\fP \f2string\fP +.LP +\f2num\fP ::= {\f2digit\fP | \f3.\fP}+ +.LP +\f2digit\fP ::= \f30\fP | \f31\fP | \f32\fP | \f33\fP | \f34\fP | \f35\fP | \f36\fP | \f37\fP | \f38\fP | \f39\fP +.LP +\f2id\fP ::= {\f2idchar\fP | \f3.\fP}+ +.LP +\f2sym\fP ::= {\f2idchar\fP}+ +.LP +\f2idchar\fP ::= any visible graphic character except \f2special\fP +.LP +\f2special\fP ::= \f3$\fP | \f3,\fP | \f3.\fP | \f3:\fP | \f3;\fP | \f3@\fP +.LP +\f2string\fP ::= \f3@\fP{any character, with \f3@\fP doubled}*\f3@\fP +.LP +\f2word\fP ::= \f2id\fP | \f2num\fP | \f2string\fP | \f3:\fP +.LP +\f2intchar\fP ::= any character, except \f3@\fP +.LP +\f2thirdp\fP ::= \f3^L\fP {\f2intchar\fP}* +.LP +\f2intstring\fP ::= \f3@\fP {\f2intchar\fP}* {\f2thirdp\fP}* \f3@\fP +.fi +.PP +In releases prior to 5.8 (2011-08-30), the grammar included the +.I newphrase +production and used it in the +.IR admin , +.I delta +and +.I deltatext +productions. +This allowed third-party programs to interoperate with \*r +by storing opaque (to \*r) data in the file. +As of 5.8, in the name of progress (towards more systematic file +integrity support), the only area reserved for third-party interop is in +the (string) value of the +.I integrity +field, specifically after the first +.B ^L +(formfeed). +A further restriction (for all programs) is that the +.I integrity +value must not contain +.BR @ . +.PP +Identifiers are case sensitive. Keywords are in lower case only. +The sets of keywords and identifiers can overlap. +In most environments \*r uses the \s-1ISO\s0 8859/1 encoding: +visible graphic characters are codes 041\-176 and 240\-377, +and white space characters are codes 010\-015 and 040. +.PP +Dates, which appear after the +.B date +keyword, are of the form +\f2Y\fP\f3.\fP\f2mm\fP\f3.\fP\f2dd\fP\f3.\fP\f2hh\fP\f3.\fP\f2mm\fP\f3.\fP\f2ss\fP, +where +.I Y +is the year, +.I mm +the month (01\-12), +.I dd +the day (01\-31), +.I hh +the hour (00\-23), +.I mm +the minute (00\-59), +and +.I ss +the second (00\-60). +.I Y +contains just the last two digits of the year +for years from 1900 through 1999, +and all the digits of years thereafter. +Dates use the Gregorian calendar; times use UTC. +.PP +The +.I delta +nodes form a tree. All nodes whose numbers +consist of a single pair +(e.g., 2.3, 2.1, 1.3, etc.) +are on the trunk, and are linked through the +.B next +field in order of decreasing numbers. +The +.B head +field in the +.I admin +node points to the head of that sequence (i.e., contains +the highest pair). +The +.B branch +node in the admin node indicates the default +branch (or revision) for most \*r operations. +If empty, the default +branch is the highest branch on the trunk. +.PP +All +.I delta +nodes whose numbers consist of +.RI 2 n +fields +.RI ( n \(>=2) +(e.g., 3.1.1.1, 2.1.2.2, etc.) +are linked as follows. +All nodes whose first +.RI 2 n \-1 +number fields are identical are linked through the +.B next +field in order of increasing numbers. +For each such sequence, +the +.I delta +node whose number is identical to the first +.RI 2 n \-2 +number fields of the deltas on that sequence is called the branchpoint. +The +.B branches +field of a node contains a list of the +numbers of the first nodes of all sequences for which it is a branchpoint. +This list is ordered in increasing numbers. +.LP +The following diagram shows an example of an \*o's organization. +.if !\np \{\ +.nf +.vs 12 +.ne 36 +.cs 1 20 +.eo + + Head + | + | + v / \ + --------- / \ + / \ / \ | | / \ / \ + / \ / \ | 2.1 | / \ / \ + / \ / \ | | / \ / \ +/1.2.1.3\ /1.3.1.1\ | | /1.2.2.2\ /1.2.2.1.1.1\ +--------- --------- --------- --------- ------------- + ^ ^ | ^ ^ + | | | | | + | | v | | + / \ | --------- / \ | + / \ | \ 1.3 / / \ | + / \ ---------\ / / \----------- +/1.2.1.1\ 1.3.1 \ / /1.2.2.1\ 1.2.2.1.1 +--------- \ / --------- + ^ | ^ + | | | + | v | + | --------- | + | \ 1.2 / | + ----------------------\ /--------- + 1.2.1 \ / 1.2.2 + \ / + | + | + v + --------- + \ 1.1 / + \ / + \ / + \ / + +.ec +.cs 1 +.vs +.fi +.\} +.if \np \{\ +.PS 4.250i 3.812i +.\" -2.0625 -4.25 1.75 0 +.\" 0.000i 4.250i 3.812i 0.000i +.nr 00 \n(.u +.nf +.nr 0x 1 +\h'3.812i' +.sp -1 +\h'2.062i-(\w'Head'u/2u)'\v'0.125i-(0v/2u)+0v+0.22m'Head +.sp -1 +\h'2.087i'\v'0.647i'\D'l -0.025i 0.100i' +.sp -1 +\h'2.038i'\v'0.647i'\D'l 0.025i 0.100i' +.sp -1 +\h'2.062i'\v'0.250i'\D'l 0.000i 0.497i' +.sp -1 +\h'1.688i'\v'1.250i'\D'l 0.750i 0.000i' +.sp -1 +\h'2.438i'\v'1.250i'\D'l 0.000i -0.500i' +.sp -1 +\h'2.438i'\v'0.750i'\D'l -0.750i 0.000i' +.sp -1 +\h'1.688i'\v'0.750i'\D'l 0.000i 0.500i' +.sp -1 +\h'2.062i-(\w'2.1'u/2u)'\v'1.000i-(0v/2u)+0v+0.22m'2.1 +.sp -1 +\h'2.087i'\v'1.647i'\D'l -0.025i 0.100i' +.sp -1 +\h'2.038i'\v'1.647i'\D'l 0.025i 0.100i' +.sp -1 +\h'2.062i'\v'1.250i'\D'l 0.000i 0.497i' +.sp -1 +\h'2.062i-(\w'1.3'u/2u)'\v'1.950i-(0v/2u)+0v+0.22m'1.3 +.sp -1 +\h'2.062i'\v'2.250i'\D'l -0.375i -0.500i' +.sp -1 +\h'1.688i'\v'1.750i'\D'l 0.750i 0.000i' +.sp -1 +\h'2.438i'\v'1.750i'\D'l -0.375i 0.500i' +.sp -1 +\h'1.350i'\v'1.603i'\D'l 0.025i -0.100i' +.sp -1 +\h'1.400i'\v'1.603i'\D'l -0.025i -0.100i' +.sp -1 +\h'1.875i'\v'2.000i'\D'~ -0.500i 0.000i 0.000i -0.497i' +.sp -1 +\h'1.375i-(\w'1.3.1'u/2u)'\v'2.100i-(0v/2u)+0v+0.22m'1.3.1 +.sp -1 +\h'1.375i-(\w'1.3.1.1'u/2u)'\v'1.400i-(0v/2u)+0v+0.22m'1.3.1.1 +.sp -1 +\h'1.375i'\v'1.000i'\D'l -0.375i 0.500i' +.sp -1 +\h'1.000i'\v'1.500i'\D'l 0.750i 0.000i' +.sp -1 +\h'1.750i'\v'1.500i'\D'l -0.375i -0.500i' +.sp -1 +\h'2.087i'\v'2.647i'\D'l -0.025i 0.100i' +.sp -1 +\h'2.038i'\v'2.647i'\D'l 0.025i 0.100i' +.sp -1 +\h'2.062i'\v'2.250i'\D'l 0.000i 0.497i' +.sp -1 +\h'2.062i-(\w'1.2'u/2u)'\v'2.950i-(0v/2u)+0v+0.22m'1.2 +.sp -1 +\h'2.062i'\v'3.250i'\D'l -0.375i -0.500i' +.sp -1 +\h'1.688i'\v'2.750i'\D'l 0.750i 0.000i' +.sp -1 +\h'2.438i'\v'2.750i'\D'l -0.375i 0.500i' +.sp -1 +\h'0.350i'\v'2.603i'\D'l 0.025i -0.100i' +.sp -1 +\h'0.400i'\v'2.603i'\D'l -0.025i -0.100i' +.sp -1 +\h'1.875i'\v'3.000i'\D'~ -0.500i 0.000i -0.500i 0.000i -0.500i 0.000i 0.000i -0.497i' +.sp -1 +\h'0.375i-(\w'1.2.1'u/2u)'\v'3.100i-(0v/2u)+0v+0.22m'1.2.1 +.sp -1 +\h'0.375i-(\w'1.2.1.1'u/2u)'\v'2.400i-(0v/2u)+0v+0.22m'1.2.1.1 +.sp -1 +\h'0.375i'\v'2.000i'\D'l -0.375i 0.500i' +.sp -1 +\h'0.000i'\v'2.500i'\D'l 0.750i 0.000i' +.sp -1 +\h'0.750i'\v'2.500i'\D'l -0.375i -0.500i' +.sp -1 +\h'0.350i'\v'1.603i'\D'l 0.025i -0.100i' +.sp -1 +\h'0.400i'\v'1.603i'\D'l -0.025i -0.100i' +.sp -1 +\h'0.375i'\v'2.000i'\D'l 0.000i -0.497i' +.sp -1 +\h'0.375i-(\w'1.2.1.3'u/2u)'\v'1.400i-(0v/2u)+0v+0.22m'1.2.1.3 +.sp -1 +\h'0.375i'\v'1.000i'\D'l -0.375i 0.500i' +.sp -1 +\h'0.000i'\v'1.500i'\D'l 0.750i 0.000i' +.sp -1 +\h'0.750i'\v'1.500i'\D'l -0.375i -0.500i' +.sp -1 +\h'2.725i'\v'2.603i'\D'l 0.025i -0.100i' +.sp -1 +\h'2.775i'\v'2.603i'\D'l -0.025i -0.100i' +.sp -1 +\h'2.250i'\v'3.000i'\D'~ 0.500i 0.000i 0.000i -0.497i' +.sp -1 +\h'2.750i-(\w'1.2.2'u/2u)'\v'3.100i-(0v/2u)+0v+0.22m'1.2.2 +.sp -1 +\h'2.750i-(\w'1.2.2.1'u/2u)'\v'2.400i-(0v/2u)+0v+0.22m'1.2.2.1 +.sp -1 +\h'2.750i'\v'2.000i'\D'l -0.375i 0.500i' +.sp -1 +\h'2.375i'\v'2.500i'\D'l 0.750i 0.000i' +.sp -1 +\h'3.125i'\v'2.500i'\D'l -0.375i -0.500i' +.sp -1 +\h'3.413i'\v'1.353i'\D'l 0.025i -0.100i' +.sp -1 +\h'3.462i'\v'1.353i'\D'l -0.025i -0.100i' +.sp -1 +\h'2.938i'\v'2.250i'\D'~ 0.500i 0.000i 0.000i -0.500i 0.000i -0.497i' +.sp -1 +\h'3.438i-(\w'1.2.2.1.1'u/2u)'\v'2.350i-(0v/2u)+0v+0.22m'1.2.2.1.1 +.sp -1 +\h'3.438i-(\w'\s-21.2.2.1.1.1\s0'u/2u)'\v'1.150i-(0v/2u)+0v+0.22m'\s-21.2.2.1.1.1\s0 +.sp -1 +\h'3.438i'\v'0.750i'\D'l -0.375i 0.500i' +.sp -1 +\h'3.062i'\v'1.250i'\D'l 0.750i 0.000i' +.sp -1 +\h'3.812i'\v'1.250i'\D'l -0.375i -0.500i' +.sp -1 +\h'2.725i'\v'1.603i'\D'l 0.025i -0.100i' +.sp -1 +\h'2.775i'\v'1.603i'\D'l -0.025i -0.100i' +.sp -1 +\h'2.750i'\v'2.000i'\D'l 0.000i -0.497i' +.sp -1 +\h'2.750i-(\w'1.2.2.2'u/2u)'\v'1.400i-(0v/2u)+0v+0.22m'1.2.2.2 +.sp -1 +\h'2.750i'\v'1.000i'\D'l -0.375i 0.500i' +.sp -1 +\h'2.375i'\v'1.500i'\D'l 0.750i 0.000i' +.sp -1 +\h'3.125i'\v'1.500i'\D'l -0.375i -0.500i' +.sp -1 +\h'2.087i'\v'3.647i'\D'l -0.025i 0.100i' +.sp -1 +\h'2.038i'\v'3.647i'\D'l 0.025i 0.100i' +.sp -1 +\h'2.062i'\v'3.250i'\D'l 0.000i 0.497i' +.sp -1 +\h'2.062i-(\w'1.1'u/2u)'\v'3.950i-(0v/2u)+0v+0.22m'1.1 +.sp -1 +\h'2.062i'\v'4.250i'\D'l -0.375i -0.500i' +.sp -1 +\h'1.688i'\v'3.750i'\D'l 0.750i 0.000i' +.sp -1 +\h'2.438i'\v'3.750i'\D'l -0.375i 0.500i' +.sp -1 +.sp 4.250i+1 +.if \n(00 .fi +.br +.nr 0x 0 +.PE +.\} +.PP +.ds EY 1990, 1991, 1992, 1993, 1994, 1995 +.SH IDENTIFICATION +Author: Walter F. Tichy. +.br +Manual Page Revision: \*(Rv; Release Date: \*(Dt. +.br +Copyright \(co 2010-2022 Thien-Thi Nguyen. +.br +Copyright \(co \*(EY Paul Eggert. +.br +Copyright \(co 1982, 1988, 1989 Walter F. Tichy. +.br +.SH "SEE ALSO" +.BR ci (1), +.BR co (1), +.BR ident (1), +.BR rcs (1), +.BR rcsclean (1), +.BR rcsdiff (1), +.BR rcsmerge (1), +.BR rlog (1). +.PP +Walter F. Tichy, +\*r\*-A System for Version Control, +.I "Software\*-Practice & Experience" +.BR 15 , +7 (July 1985), 637-654. +.PP +The full documentation for \*r is maintained as a Texinfo manual. +If the +.BR info (1) +and \*r programs are properly installed at your site, the command +.IP +.B info rcs +.PP +should give you access to the complete manual. +Additionally, the \*r homepage: +.IP +.B http://www.gnu.org/software/rcs/ +.PP +has news and links to the latest release, development site, etc. -- cgit v1.2.3