prs(1)prs(1)NAMEprs - Displays key information in a Source Code Control System (SCCS)
file
SYNOPSISprs [-a] [-d dataspec] [-r[SID]] file...
prs [-e | -l] [-c cutoff] [-d dataspec] file...
prs [-e | -l] -r[SID] [-d dataspec] file...
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
prs: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
Writes information for the specified deltas, whether or not they were
removed (see the rmdel(1) reference page). If you do not specify the
-a option, prs supplies information only for the specified deltas that
were not removed. Specifies a cutoff date and time for the -e and -l
options. Specify cutoff in the following form: yy[mm[dd[hh[mm[ss]]]]]
All omitted items default to their maximum values, so specifying
-c9002 is the same as specifying -c900229235959. You can sepa‐
rate the fields with any nonnumeric characters. For example,
you can specify: -c90/2/20,9:22:25
or -c"90/2/20 9:22:25"
or "-c90/2/20 9:22:25"
[Tru64 UNIX] For the yy component, values in the range [69-99],
prs interprets it as being in the twentieth century, i.e. (1969
to 1999 inclusive); values in the range [00-68], prs interprets
it as being in the twenty-first century ie. (2000 to 2068 inclu‐
sive). Specifies the data items to be displayed. The dataspec
string consists of optional text and SCCS file data keywords.
You must enclose all text and spaces in dataspec in "" (double
quotes). Requests information for all deltas created earlier
than (and including) the delta specified by the -r option.
Requests information for all deltas created later than (and
including) the delta specified by the -r option. Specifies the
SID of a delta for which prs will retrieve information. If no
SID is specified, prs retrieves the information for the SID of
the highest numbered delta. If SID is specified, you must not
use a space between the -r and the SID.
OPERANDS
The path name of an existing SCCS file or directory.
If you specify a directory in place of file, prs performs the
requested actions on all SCCS files (those with a name that has
the s. prefix).
If you specify a - (dash) in place of file, the prs command
reads standard input and interprets each line as the name of an
SCCS file. The prs command continues to take input until it
reads an End-of-File character.
DESCRIPTION
The prs command reads SCCS files, and writes to standard output a part
or all of the file according to a format you specify.
Data Keywords
Data keywords specify the parts of an SCCS file to be retrieved and
written to standard output. All parts of an SCCS file have an associ‐
ated data keyword. There is no limit to the number of times a data
keyword can appear in a string.
The information that prs displays consists of user-supplied text and
appropriate values (extracted from the SCCS file) substituted for the
recognized data keywords in the order of appearance in string. The
format of a data keyword value is either simple, where the keyword sub‐
stitution is direct, or multiline, where the substitution is followed
by a carriage return. Text is any characters other than recognized
data keywords. Specify a tab character with \t and a carriage return
or newline character with \n. Remember to quote the \t and \n with an
extra \ (slash) to prevent the shell from interpreting the single \ and
just passing a t or n to prs as text.
The following table lists the keywords associated with information in
the delta table in the SCCS file (see the sccsfile(4) reference page
for information about file structure).
Delta Table Keywords
────────────────────────────────────────────────────────────
Keyword Data Represented Value Format
────────────────────────────────────────────────────────────
:R: Release number num Simple
:L: Level number num Simple
:B: Branch number num Simple
:S: Sequence number num Simple
:I: SCCS ID string :R::L::B::S: Simple
(SID)
:Dy: Year delta cre‐ YY Simple
ated
:Dm: Month delta cre‐ MM Simple
ated
:Dd: Day delta created DD Simple
:D: Date delta cre‐ YY/MM/DD Simple
ated
:Th: Hour delta cre‐ HH Simple
ated
:Tm: Minute delta cre‐ MM Simple
ated
:Ts: Second delta cre‐ SS Simple
ated
:T: Time delta cre‐ HH/MM/SS Simple
ated
:DT: Delta type~D or
R~Simple
:P: User who created login name Simple
the delta
:DS: Delta sequence num Simple
number
:DP: Previous delta num Simple
sequence number
:Dt: Delta information :DT::I::D: Simple
:T::P::DS::DP:
:Dn: Sequence numbers :DS:... Simple
of deltas
included
:Dx: Sequence numbers :DS:... Simple
of deltas
excluded
:Dg: Sequence numbers :DS:... Simple
of deltas ignored
:DI: Sequence numbers :Dn:/:Dx:/:Dg: Simple
of deltas
included,
excluded, and
ignored
:Li: Lines inserted by num Simple
Delta
:Ld: Lines deleted by num Simple
Delta
:Lu: Lines unchanged num Simple
by Delta
:DL: Delta line sta‐ :Li:/:Ld:/:Lu: Simple
tistics
:MR: MR numbers for text Multiline
delta
:C: Comments for text Multiline
delta
────────────────────────────────────────────────────────────
The following table lists the keywords associated with the header flags
in the SCCS file. For more information on header flags, see the
admin(1) reference page.
Header Flag Keywords
────────────────────────────────────────────────────
Keyword Data Represented Value Format
────────────────────────────────────────────────────
:Y: Module type text Simple
:MF: MR validation yes or no Simple
flag set
:MP: MR validation text Simple
program name
:KF: Keyword/error yes or no Simple
warning flag set
:KV: Keyword valida‐ text Simple
tion string
:BF: Branch flag set yes or no Simple
:J: Joint edit flag yes or no Simple
set
:LK: Locked releases :R:... Simple
:Q: User-defined key‐ text Simple
word
:M: Module name text Simple
:FB: Floor boundary :R: Simple
:CB: Ceiling boundary :R: Simple
:Ds: Default SID :I: Simple
:ND: Null delta flag yes or no Simple
set
:FL: Header flag list text Multiline
────────────────────────────────────────────────────
The following table lists the keywords associated with other parts of
the SCCS file.
Other Keywords
────────────────────────────────────────────────────────────
Keyword Data Represented Value Format
────────────────────────────────────────────────────────────
:UN: Usernames text Multiline
:FD: Descriptive text text Multiline
:BD: Body of text text Multiline
:GB: Text in a g-file text Multiline
:W: what string :Z::M: <Tab> :I: Simple
:A: what string :Z::Y::M::I::Z: Simple
:Z: what string @(#) Simple
delimiter
:F: SCCS file name text Simple
:PN: SCCS file path text Simple
name
────────────────────────────────────────────────────────────
EXIT STATUS
The following exit values are returned: Successful completion. An
error occurred.
EXAMPLES
To display information on all deltas generated for SCCS file name
s.test.c (including all deltas removed using rmdel), enter: prs-a
s.test.c To display username, the number of lines inserted by delta,
and the number of lines deleted by delta for SID 1.2 of s.test.c,
enter: prs-r1.2 -d":P::Li::Ld:" s.test.c
ENVIRONMENT VARIABLES
The following environment variables affect the execution of prs: Pro‐
vides a default value for the internationalization variables that are
unset or null. If LANG is unset or null, the corresponding value from
the default locale is used. If any of the internationalization vari‐
ables contain an invalid setting, the utility behaves as if none of the
variables had been defined. If set to a non-empty string value, over‐
rides the values of all the other internationalization variables.
Determines the locale for the interpretation of sequences of bytes of
text data as characters (for example, single-byte as opposed to multi‐
byte characters in arguments and input files). Determines the locale
for the format and contents of diagnostic messages written to standard
error. Determines the location of message catalogues for the process‐
ing of LC_MESSAGES.
FILES
Temporary files.
SEE ALSO
Commands: admin(1), cdc(1), comb(1), delta(1), get(1), rmdel(1),
sact(1), sccs(1), sccsdiff(1), sccshelp(1), unget(1), val(1), what(1)
Files: sccsfile(4)
Standards: standards(5)
Programming Support Tools
prs(1)