rcs: Delim-separated list
2.1.9 Delim-separated list
--------------------------
Some options that require (or allow) additional information can take
multiple items of that information in the form of a “delim-separated
list”, a concatenation of items with one or more delimiter characters
between adjacent items. Multiple adjacent delim characters count as a
single delimiter.
Most often you will use comma (‘,’ or U+2C), but RCS also permits
others, depending on context. In the following table, “SPC” is the
space character (U+20), “LF” is the linefeed character (U+0A), “TAB” is
the tab character (U+09), and “semi” is ‘;’ (U+3B).
context permitted delimiter characters, notes
--------------------------------------------------------------------------
co -jJOINS SPC TAB comma
JOINS is a delim-separated list, each item of which
is a “join pair” of the form REV:REV. ⇒co.
rcs -aACCESSORS SPC LF TAB comma
rcs -eACCESSORS ACCESSORS is a delim-separated list of logins.
⇒rcs.
rcs -oREVSPECS semi comma
rlog -rREVSPECS “revspecs” is a delim-separated list, each item of
which has one of the forms:
REV
REV1: REV1-
REV1:REV2 REV1-REV2
The variants in the second column use hyphen (‘-’,
U+2D). They are obsolete and should be avoided.
They are ambiguous in the presence of symbolic
branch and revision names that include a hyphen in
the name (⇒Revision options).
⇒rcs, ⇒rlog. Note that although the
“join pair” for co -j above is identical to a
‘REV1:REV2’ revspec, the set of delim characters is
different.
rlog -lLOCKERS SPC TAB LF semi comma
rlog -w[AUTHORS] Both LOCKERS and AUTHORS are a delim-separated list
of logins. Note that AUTHORS is completely
optional. ⇒rlog.
rlog -sSTATES SPC TAB LF semi comma
STATES is a delim-separated list of states
(⇒State option). ⇒rlog.
rlog -dDATES SPC TAB LF semi comma
DATES is a delim-separated list of date/time
specifications (⇒Date option). ⇒rlog.
Maintainer’s Note: This embarrassment of choice for delim characters
will probably be reduced to simply one character in RCS 6: comma.