prs(1) UNIX System V(Enhanced Programming Utilities) prs(1)
NAME
prs - print an SCCS file
SYNOPSIS
prs [-d[dataspec]] [-r[SID]] [-e] [-l] [-c[date-time]] [-a] files
DESCRIPTION
prs prints, on the standard output, parts or all of an SCCS file [see
sccsfile(4)] in a user-supplied format. If a directory is named, prs
prints the files in that directory, except the non-SCCS files (last
component of the path name does not begin with s.) and unreadable files.
If a name of - is given, the standard input is read; each line of the
standard input is taken to be the name of an SCCS file or directory to be
processed. prs silently ignores non-SCCS files and unreadable files.
Arguments to prs, which may appear in any order, consist of keyletter
arguments and file names.
The keyletter arguments apply independently to each named file:
-d[dataspec] Specifies the output data specification. The
dataspec is a string consisting of SCCS file data
keywords (see the DATA KEYWORDS section) interspersed
with optional user-supplied text.
-r[SID] Specifies the SCCS identification (SID) string of a
delta for which information is desired. The default
is the top delta.
-e Requests information for all deltas created earlier
than and including the delta designated via the -r
keyletter 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
keyletter or the date given by the -c option.
-c[date-time] The cutoff date-time in the form:
YY[MM[DD[HH[MM[SS]]]]]
Units omitted from the date-time default to their
maximum possible values; for example, -c7502 is
equivalent to -c750228235959. Any number of non-
numeric characters may separate the fields of the
cutoff date; for example, "-c77/2/2 9:22:25".
-a Requests printing of information for both removed,
that is, delta type = R, [see rmdel(1)] and existing,
that is, delta type = D, deltas. If the -a keyletter
is not specified, information for existing deltas
only is provided.
10/89 Page 1
prs(1) UNIX System V(Enhanced Programming Utilities) prs(1)
DATA KEYWORDS
Data keywords specify those parts of an SCCS file that are to be
retrieved and output. All parts of an SCCS file [see sccsfile(4)] 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: (1) the user-supplied text;
and (2) 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 ``Multi-line'' (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 carriage return/new-line is specified by \n.
The default data keywords are:
":Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:"
Keyword Data Item File Section Value Format
_________________________________________________________________________
:Dt: Delta information Delta Table See below* S
:DL: Delta line statistics " :Li:/:Ld:/:Lu: S
:Li: Lines inserted by Delta " nnnnn S
:Ld: Lines deleted by Delta " nnnnn S
:Lu: Lines unchanged by " nnnnn S
Delta
:DT: Delta type " D or R S
:I: SCCS ID string (SID) " :R:.:L:.:B:.:S: S
:R: Release number " nnnn S
:L: Level number " nnnn S
:B: Branch number " nnnn S
:S: Sequence number " nnnn S
:D: Date Delta created " :Dy:/:Dm:/:Dd: S
:Dy: Year Delta created " nn S
:Dm: Month Delta created " nn S
:Dd: Day Delta created " nn S
:T: Time Delta created " :Th:::Tm:::Ts: S
:Th: Hour Delta created " nn S
:Tm: Minutes Delta created " nn S
:Ts: Seconds Delta created " nn S
:P: Programmer who created " logname S
Delta
:DS: Delta sequence number " nnnn S
:DP: Predecessor Delta seq- " nnnn S
no.
:DI: Seq-no. of deltas " :Dn:/:Dx:/:Dg: S
incl., excl., ignored
:Dn: Deltas included (seq #) " :DS: :DS:... S
:Dx: Deltas excluded (seq #) " :DS: :DS:... S
:Dg: Deltas ignored (seq #) " :DS: :DS:... S
:MR: MR numbers for delta " text M
Page 2 10/89
prs(1) UNIX System V(Enhanced Programming Utilities) prs(1)
:C: Comments for delta " text M
:UN: User names User Names text M
:FL: Flag list Flags text M
Keyword Data Item File Section Value Format
_________________________________________________________________________
:Y: Module type flag " text S
:MF: MR validation flag " yes or no S
:MP: MR validation pgm name " text S
:KF: Keyword error/warning " yes or no S
flag
:KV: Keyword validation string " text S
:BF: Branch flag " yes or no S
:J: Joint edit flag " yes or no S
:LK: Locked releases " :R:... S
:Q: User-defined keyword " text S
:M: Module name " text S
:FB: Floor boundary " :R: S
:CB: Ceiling boundary " :R: S
:Ds: Default SID " :I: S
:ND: Null delta flag " yes or no S
:FD: File descriptive text Comments text M
:BD: Body Body text M
:GB: Gotten body " text M
:W: A form of what(1) string N/A :Z::M:\t:I: S
:A: A form of what(1) string N/A :Z::Y: :M: :I::Z: S
:Z: what(1) string delimiter N/A @(#) S
:F: SCCS file name N/A text S
:PN: SCCS file path name N/A text S
* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP:
EXAMPLES
The command
prs -d"Users and/or user IDs for :F: are:\n:UN:" s.file
may produce on the standard output:
Users and/or user IDs for s.file are:
xyz
131
abc
The command
prs -d"Newest delta for pgm :M:: :I: Created :D: By :P:" -r s.file
may produce on the standard output:
Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas
10/89 Page 3
prs(1) UNIX System V(Enhanced Programming Utilities) prs(1)
The default case:
prs s.file
produces on the standard output:
D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000
MRs:
bl78-12345
bl79-54321
COMMENTS:
this is the comment line for s.file initial delta
for each delta table entry of the ``D'' type. The only keyletter
argument allowed to be used with the ``special case'' is the -a
keyletter.
FILES
/var/tmp/pr?????
SEE ALSO
admin(1), delta(1), get(1), help(1), sccsfile(4)
DIAGNOSTICS
Use help(1) for explanations.
Page 4 10/89