The prs command prints, on standard output, parts or
all of an SCCS file (see
sccsfile(FP))
in a user-supplied format.
If a directory is named, prs behaves as though each file
in the directory were specified as a named file, except that
non-SCCS files and unreadable files are silently ignored.
If a name of ``-'' is given, the standard input is read;
each line of standard input is taken to be the name of an
SCCS file or directory to be processed; non-SCCS
files and unreadable files are silently ignored.
Arguments to prs may appear in any order.
All the described arguments apply independently to each named file:
-d[dataspec]
Used to specify the output data specification.
The dataspec is a string consisting of SCCS
file data keywords (see ``Data Keywords'')
interspersed with optional user-supplied text.
-r[SID]
Used to specify the SCCS identification (SID) string of
a delta for which information is desired.
If no SID is specified, the SID
of the most recently created delta is assumed.
-e
Requests information for all deltas created earlier
than and including the delta designated via the -r
option or the date given by the -c option.
-l
Requests information for all deltas created later
than and including the delta designated via the -r
option or the date given by the -c option.
-c[date-time]
The cutoff [date-time] is in the form:
YY[MM[DD[HH[MM[SS]]]]]
For the YY component,
year within century. When a century is not otherwise specified,
values in the range 69-99 refer to years in the twentieth
century (1969 to 1999 inclusive); values in the range 00-68
refer to years in the twenty-first century (2000 to 2068
inclusive).
Units omitted from the [date-time] default to their
maximum possible values; that is, -c9502
is equivalent to -c950228235959.
The -c option must be used with the -e
or -l option.
Any number of non-numeric characters may separate
the various two-digit pieces of the cutoff date in the form:
-c"94/12/2 9:22:25"
-a
Requests printing of information for both removed (delta type
R) and existing (delta type D) deltas (see
rmdel(CP).
If -a is not specified, information is provided for
existing deltas only.
Data keywords
Data keywords specify which parts of an SCCS file are
to be retrieved and output.
All parts of an SCCS file (see
sccsfile(FP))
have an associated data keyword. There is no limit on the
number of times a data keyword may appear in a dataspec.
The information printed by prs consists of the
user-supplied text and appropriate values (extracted from the
SCCS file) substituted for the recognized data keywords
in the order of appearance in the dataspec.
The format of a data keyword value is either Simple (S),
in which keyword substitution is direct, or Multiline (M),
in which keyword substitution is followed by a carriage return.
User-supplied text is any text other than recognized data keywords.
A tab is specified by \t and new-line is specified by \n.
The default data keywords are: