[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
prs
The prs
command (mnemonic: "print revision summary") prints
information about an SCCS file in a user-defined format. There are
options for selecting which deltas are reported on; selection is
possible by check-in time or by SID. The format of the output can
also be specified on the command line. All parts of an SCCS file
can be dumped with prs
. Those parts which appear once per delta
can be uniquely identified by SID or by time.
Typical uses for prs
are
get -m
command is also useful for
this, see Options for get
.
3.8.1 Basic Usage for prs | Frequently-used prs commands
| |
3.8.2 Options for prs | Full list of options | |
3.8.3 Data Keywords for the `-d' option of prs | Data Keyword Substitution |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
prs
Here are some examples of the use of prs, with explanations of what they do.
Show information about all the versions of `myfile.c'.
Show information about all the SCCS files in the directory `SCCS'.
Show which users have made changes to main.c.
Examine all the SCCS files in the directory `SCCS'. Show any deltas that have been created since last week.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
prs
Include even removed deltas in the output. Removed deltas have a type "R", as output by the :DT: keyword.
Specifies the time of the "cutoff". When this option is given, the
delta selected by prs
is the last one checked in before the
cutoff. As usual, any fields left unspecified in the cutoff are given
the maximum legal value (for example, the seconds field defaults to 59).
The fields can be separated by any non-numeric character, for example
`-c97/11/02-11:25:42'.
As an extension specific to CSSC, if the argument contains more than twelve (12) digits, and the first four characters are all digits, it is assumed that a four-digit year form has been used. This means that you can say `-c1997/11/02-11:25:42' to mean the same as the above.
In line with the X/Open CAE Specification, Commands and Utilities (version 2, September 1994, pages 588 and 361), if the century field is not given and the year is less than 69, it is assumed to be a year in the twenty-first century. The X/Open document does not mandate a four-digit year specifier, but it would not make sense to apply this rule if a four-digit year is specified. See section Year 2000 Issues.
This behaviour is usually not the one required, and hence the `-e' or `-l' options are specified too.
This specifies the data format for the output. Because the default
output format is sensible, this is typically used either in a shell
script which will process the output further, or by a human to retrieve
information which is not shown by default. See Data Keywords for the `-d' option of prs
for
the various keywords that can be used. Any characters in the data
format which are not part of a keyword are output as well.
If one specifies the `-d' option, prs
by default only gives
information about the latest delta. To restore the default behavior of
showing all the deltas, use the `-e' option as well.
Makes the `-c' option select deltas created at or earlier than the specified time. Makes the `-r' option select deltas before and including the one specified by the indicated SID.
As the `-e' option, but select only later deltas rather than earlier ones.
Specifies the SID for which information is provided. If blank, the latest delta is selected.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
prs
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
These keywords expand to the same thing, no matter which version is being examined. Many of these are SCCS file flags (see section Flags).
:BD:
Emits the body of the SCCS file, that is, the part containing all
the delta information. Note that since this is dumped verbatim, it
contains control characters. If you want a more readable format,
consider using the `-b' option of prt
(see section Options for prt
).
:BF:
Indicates the setting (`yes' or `no') of the branch flag.
:CB:
Indicates the value of the release number ceiling flag.
:Ds:
:F:
Name of the SCCS file.
:FB:
Indicates the value of the release floor boundary flag.
:FD:
File descriptive text (see section admin
).
:FL:
List of SCCS file flags.
:J:
Value (`yes' or `no') of the joint-edit flag.
:KF:
Value (`yes' or `no') of the keyword-warning flag (see section admin
).
:LK:
Value of the locked-releases flag.
:M:
The module name (the value of the `m' flag).
:MF:
The value (`yes' or `no') of the MR validation flag
(see section delta
).
:MP:
The value of the MR validation program flag (see section delta
). This
is usually the name of an executable file.
:ND:
The value of the null-delta (`n') flag (`yes' or `no').
:Q:
The value of the (user-defined) Q flag (arbitrary one-line text).
:PN:
The full path name of the SCCS file.
:UN:
List of users authorised to make deltas to this file (one per line).
This list can be modified with the use of the options `-a' and
`-e' of admin
; if this list is empty, any user is
allowed to use delta
on this file (subject to the usual file
permissions checks made by the operating system). However, in this
case the `UN' data keyword somewhat curiously expands to
`none'.
:Y:
Value of the module-type flag.
The `:BD:', `:FD:', `:FL:' and `:UN:' keywords from this section may expand to strings containing newlines.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
These keywords expand to data that is specific to a particular version.
:A:
Expands to `:Z::Y: :M: :I::Z:', useful for what
.
:B:
Branch number of SID
:C:
Comments for this delta. These may extend over several lines.
:D:
Date (yy/mm/dd) that this version was checked in. Expands to `:Dy:/:Dm:/:Dd:'. The year is always represented as two digits but is not ambiguous since the two-digit year is no later than 2068 (see section Year 2000 Issues).
:Dd:
Day-of-month on which the delta was checked in (two digits).
:Dg:
Sequence numbers of ignored deltas (separated by white space).
:DI:
Expands to `:Dn:/:Dx:/:Dg:' (sequence numbers included/excluded/ignored).
:DL:
Expands to `:Li:/:Ld:/:Lu:' (lines inserted/deleted/unchanged).
:Dm:
Month when this version as checked in (two digits).
:Dn:
Sequence numbers of included deltas (separated by white space).
:DP:
Sequence number of the delta that precedes this one.
:DS:
Sequence number of this delta.
:Dt:
Expands to `:DT: :I: :D: :T: :P: :DS: :DP:'.
:DT:
Delta type: `R' (removed) or `D' (normal).
:Dx:
Sequence numbers of excluded deltas (separated by white space).
:Dy:
Year when this version was checked in. The year is always represented as two digits but is not ambiguous since the two-digit year is no later than 2068 (see section Year 2000 Issues).
:GB:
The body for this version, as distinct from the
body of the SCCS file itself, which is obtained
with `:BD:'. Keyword expansion will be performed
in the same way as if get
had been used.
:I:
The SID of this version.
:L:
The level component of the SID (that is, the second number).
:Ld:
Number of lines deleted in this version, with respect to its predecessor.
:Li:
Number of lines inserted in this version, with respect to its predecessor.
:Lu:
Number of lines unchanged in this version, with respect to its predecessor.
:MR:
The MR numbers specified when this delta was created.
:P:
Perpetrator: the login name of the user who created this delta.
:R:
The release number of the SID (the first number).
:S:
The sequence number of the SID. Don't confuse this with the delta sequence numbers (see section The Delta Table), which are internal identifiers for deltas which are output by the keywords :DI:, :Dn:, :Dx: and :Dg:.
:T:
Time that this version was checked in (`:Th:::Tm:::Ts:').
:Th:
Hours component of check-in time (`:T:').
:Tm:
Minutes component of check-in time (`:T:').
:Ts:
Seconds component of check-in time (`:T:').
:W:
Shorthand for `:Z::M:<TAB>:I:', suitable for what
(see section what
).
:Z:
Expands to `@(#)' (see section what
).
The `:C:', `:GB:' and `:MR:' keywords from this section may expand to strings containing newlines.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] |
This document was generated on December, 31 2005 using texi2html 1.76.