prs(1) prs(1)
NAME
prs - print an SCCS file
SYNOPSIS
prs [-a] [-r[SID]] [-d dataspec] [--] file...
prs [-e | -l] -c date-time [-d dataspec] [--] file ...
prs [-e | -l] -r[SID] [-d dataspec] [--] file ...
DESCRIPTION
prs (print SCCS-file) prints, on the standard output, parts or all of
an SCCS file [see sccsfile(4)] in a user-supplied format. If a direc-
tory is named, prs prints the files in that directory, except the
non-SCCS files (last component of the pathname 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. prs silently ignores non-SCCS files and
unreadable files.
OPTIONS
Arguments to prs, which may appear in any order, consist of keyletters
and filenames.
All the specified keyletters apply independently to each named file:
-d dataspec
Specifies the output format. dataspec is a string consisting of
SCCS file data keywords (see the Data keywords section) inter-
spersed 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, -c 7502 is equivalent to -c 750228235959. Any
number of non-numeric characters may separate the fields of the
cutoff date; for example, "-c 77/2/2 9:22:25".
Page 1 Reliant UNIX 5.44 Printed 11/98
prs(1) prs(1)
-a Requests 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 deltas only
is provided.
-- If the first filename begins with a dash (-), the end of the
command-line options must be marked with --.
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(4)] have an asso-
ciated 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 "Multi-line" (M), in which keyword
substitution is followed by a RETURN.
User-supplied text is any text other than recognized data keywords. A
tab is specified by \t and carriage return/newline is specified by \n.
The default data keywords are:
_____________________________________________________________________________
| 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 " nnnn S |
| :Ld: Lines deleted by Delta " nnnn S |
| :Lu: Lines unchanged by Delta " nnnn S |
| :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 Delta " logname S |
| :DP: Predecessor Delta seq-no. " nnnn S |
|____________________________________________________________________________|
Page 2 Reliant UNIX 5.44 Printed 11/98
prs(1) prs(1)
_____________________________________________________________________________
| Keyword Data item File Section Value Format|
|____________________________________________________________________________|
| :DI: Seq-no. of deltas incl., " :Dn:/:Dx:/:Dg: S |
| 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 |
| :Y: Module type flag " text S |
| :MF: MR validation flag " yes or no S |
| :MP: MR validation prm name " text S |
| :KF: Keyword error/warning flag " yes or no S |
| :KV: Keyword validation string " text S |
| :BF: Branch flag " yes or no S |
| :J: Joint edit flag " yes or no S |
| :LK: Locked release " :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 filename N/A text S |
| :PN: SCCS file pathname N/A text S |
|____________________________________________________________________________|
* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP:
Page 3 Reliant UNIX 5.44 Printed 11/98
prs(1) prs(1)
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
The default case:
prs s.file
produces the following on the standard output, for each "D" type entry
in the delta table:
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
The only keyletter allowed to be used for this is the -a keyletter.
LOCALE
The language of the message texts is governed by the environment vari-
able LCALL, LCMESSAGES or LANG.
When the default is set, the system behaves as if it were not interna-
tionalized, i.e. the message texts are in English. You must change one
of these variables in order to change the language of the message
texts.
Detailed information on the dependencies of the environment variables
and on internationalization in general can be found in the manual
"Programmer's Guide: Internationalization - Localization". Refer also
to environ(5) for information on setting the user environment.
FILES
/var/tmp/pr?????
Page 4 Reliant UNIX 5.44 Printed 11/98
prs(1) prs(1)
SEE ALSO
admin(1), delta(1), get(1), help(1), what(1), sccsfile(4).
Page 5 Reliant UNIX 5.44 Printed 11/98