3.8.3 Data Keywords for the -d option of prs
3.8.3.1 Global Keywords
These keywords expand to the same thing, no matter which version is
being examined. Many of these are sccs file flags (see 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 prt options).
:BF:
- Indicates the setting (‘yes’ or ‘no’) of the branch flag.
:CB:
- Indicates the value of the release number ceiling flag.
:Ds:
- The default sid to check out (See Flags and get).
:F:
- Name of the sccs file.
:FB:
- Indicates the value of the release floor boundary flag.
:FD:
- File descriptive text (see 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 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 delta).
:MP:
- The value of the mr validation program flag (see 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.
3.8.3.2 Version-specific Keywords
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 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 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 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 what).
:Z:
- Expands to ‘@(#)’ (see what).
The ‘:C:’, ‘:GB:’ and ‘:MR:’ keywords from this section
may expand to strings containing newlines.