Previous: , Up: prs   [Contents][Index]


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 the list of included, excluded and ignored sequence numbers. The sequence numbers of the included deltas are printed. If there are excluded deltas, ‘/’ is printed as a separator and then the excluded sequence numbers are printed. If there are ignored deltas, ‘/’ is printed as a separator and then the ignored sequence numbers are printed. This means it’s difficult to tell from the result of ‘:DI:’ whether the sequence numbers after the last ‘/’ were excluded or ignored. See SCCS Version Differences for a brief description of how ‘:DI:’ expands to different things on different SCCS implmentations. If you need reliable information, then you will need to use something like ‘:Dn:/:Dx:/:Dg:’ explicitly.

: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.


Previous: , Up: prs   [Contents][Index]