prs - Displays key information in a Source Code Control
System (SCCS) file
prs [-a] [-d dataspec] [-r[SID]] file...
prs [-e | -l] [-c cutoff] [-d dataspec] file...
prs [-e | -l] -r[SID] [-d dataspec] file...
Interfaces documented on this reference page conform to
industry standards as follows:
prs: XCU5.0
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
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 separate 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
inclusive). 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.
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-ofFile
character.
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 [Toc] [Back]
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 associated 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 substitution
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 [Toc] [Back]
------------------------------------------------------------
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 :Li:/:Ld:/:Lu: Simple
statistics
: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 [Toc] [Back]
----------------------------------------------------
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 [Toc] [Back]
------------------------------------------------------------
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
------------------------------------------------------------
The following exit values are returned: Successful completion.
An error occurred.
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 [Toc] [Back] The following environment variables affect the execution
of prs: Provides 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 variables contain
an invalid setting, the utility behaves as if none of
the variables had been defined. If set to a non-empty
string value, overrides 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 multibyte
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 processing of LC_MESSAGES.
Temporary files.
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)
[ Back ] |
