prs(1) USER COMMANDS 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
1
prs(1) USER COMMANDS prs(1)
-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, i.e., delta type = R, [see
rmdel(1)] and existing, i.e., delta type
= D, deltas. If the -a keyletter is not
specified, information for existing del-
tas only is provided.
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 key-
word 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 key-
words 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
2
prs(1) USER COMMANDS prs(1)
: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
: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
3
prs(1) USER COMMANDS prs(1)
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
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.
4