 |
Index for
Section 1 |
|
 |
Alphabetical
listing for P |
|
 |
Bottom of
page |
|
prs(1)
NAME
prs - Displays key information in a Source Code Control System (SCCS) file
SYNOPSIS
prs [-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 standards
as follows:
prs: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
-a 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.
-c cutoff
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).
-d dataspec
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).
-e Requests information for all deltas created earlier than (and
including) the delta specified by the -r option.
-l Requests information for all deltas created later than (and including)
the delta specified by the -r option.
-r[SID]
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
file
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 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
___________________________________________________________
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: :R::L::B::S: Simple
SCCS ID string
(SID)
:Dy: YY Simple
Year delta
created
:Dm: MM Simple
Month delta
created
:Dd: Day delta created DD Simple
:D: YY/MM/DD Simple
Date delta
created
:Th: HH Simple
Hour delta
created
:Tm: MM Simple
Minute delta
created
:Ts: SS Simple
Second delta
created
:T: HH/MM/SS Simple
Time delta
created
:DT:
Delta type~D or
R~Simple
:P: login name Simple
User who created
the delta
:DS: num Simple
Delta sequence
number
:DP: num Simple
Previous delta
sequence number
:Dt: Delta information Simple
:DT::I::D:
:T::P::DS::DP:
:Dn: :DS:... Simple
Sequence numbers
of deltas
included
:Dx: :DS:... Simple
Sequence numbers
of deltas
excluded
:Dg: :DS:... Simple
Sequence numbers
of deltas ignored
:DI: :Dn:/:Dx:/:Dg: Simple
Sequence numbers
of deltas
included,
excluded, and
ignored
:Li: num Simple
Lines inserted by
Delta
:Ld: num Simple
Lines deleted by
Delta
:Lu: num Simple
Lines unchanged
by Delta
:DL: :Li:/:Ld:/:Lu: Simple
Delta line
statistics
:MR: text Multiline
MR numbers for
delta
:C: text Multiline
Comments for
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: yes or no Simple
MR validation
flag set
:MP: text Simple
MR validation
program name
:KF: yes or no Simple
Keyword/error
warning flag set
:KV: text Simple
Keyword
validation string
:BF: Branch flag set yes or no Simple
:J: yes or no Simple
Joint edit flag
set
:LK: Locked releases :R:... Simple
:Q: text Simple
User-defined
keyword
:M: Module name text Simple
:FB: Floor boundary :R: Simple
:CB: Ceiling boundary :R: Simple
:Ds: Default SID :I: Simple
:ND: yes or no Simple
Null delta flag
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: Simple
what string
:Z::M: <Tab> :I:
:A: :Z::Y::M::I::Z: Simple
what string
:Z: @(#) Simple
what string
delimiter
:F: SCCS file name text Simple
:PN: text Simple
SCCS file path
name
___________________________________________________________
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
EXAMPLES
1. 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
2. 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:
LANG
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.
LC_ALL
If set to a non-empty string value, overrides the values of all the
other internationalization variables.
LC_CTYPE
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).
LC_MESSAGES
Determines the locale for the format and contents of diagnostic
messages written to standard error.
NLSPATH
Determines the location of message catalogues for the processing of
LC_MESSAGES.
FILES
/tmp/pr?????
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
|
Index for
Section 1 |
|
|
Alphabetical
listing for P |
|
 |
Top of
page |
|