Next: , Previous: , Up: Common elements   [Contents][Index]


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).

contextpermitted delimiter characters, notes
co -jjoinsSPC TAB comma
joins is a delim-separated list, each item of which is a join pair of the form rev:rev. See Invoking co.
rcs -aaccessors
rcs -eaccessors
SPC LF TAB comma
accessors is a delim-separated list of logins. See Invoking rcs.
rcs -orevspecs
rlog -rrevspecs
semi comma
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 (see Revision options).

See Invoking rcs, See Invoking 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
rlog -w[authors]
SPC TAB LF semi comma
Both lockers and authors are a delim-separated list of logins. Note that authors is completely optional. See Invoking rlog.
rlog -sstatesSPC TAB LF semi comma
states is a delim-separated list of states (see State option). See Invoking rlog.
rlog -ddatesSPC TAB LF semi comma
dates is a delim-separated list of date/time specifications (see Date option). See Invoking rlog.

Maintainer’s Note: This embarrassment of choice for delim characters will probably be reduced to simply one character in RCS 6: comma.


Next: Environment, Previous: Misc common options, Up: Common elements   [Contents][Index]