prs.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

prs(1) prs(1)

NAME

prs - print and summarize an SCCS ﬁle

SYNOPSIS

prs [-d dataspec] [-r

[SID]] [-e][-l][-c cutoff] [

-a] ﬁle ...

DESCRIPTION

The

prs command prints, on the standard output, parts or all of an SCCS ﬁle (see sccsﬁle(4)) in a user-

supplied format. If a directory is named,

prs

behaves as though each ﬁle in the directory were speciﬁed

as a named ﬁle, except that non-SCCS ﬁles (last component of the path name does not begin with s.),

and unreadable ﬁles are silently ignored. If a name of

- is given, the standard input is read; each line of

the standard input is taken to be the name of an SCCS ﬁle or directory to be processed; non-SCCS ﬁles

and unreadable ﬁles are silently ignored. A

-- on the command line implies that all following argu-

ments are ﬁle/directory names.

Arguments to

prs, which can appear in any order, consist of options and ﬁle names.

Options

All of the described options apply independently to each named ﬁle:

-d dataspec Used to specify the output data speciﬁcation. dataspec is a string consisting of

SCCS ﬁle data keywords (see Data Keywords below) interspersed with optional

user-supplied text.

-r [SID] Used to specify the SCCS IDentiﬁcation (SID) string of a delta for which informa-

tion is desired. If no SID is speciﬁed, the SID of the most recently created delta is

assumed. If an SID is speciﬁed, it must agree exactly with an SID in the ﬁle (that

is, the SID structure used by get does not work here — see get (1)).

-e Requests information for all deltas created earlier than and including the delta

designated via the -r option or the date given by the -c option.

-l Requests information for all deltas created later than and including the delta desig-

nated via the -r option or the date given by the -c option.

-c cutoff Cutoff date-time, in the form

YY[MM[DD[HH[MM[SS]]]]]

Units omitted from the date-time default to their maximum possible values. Thus,

-c7502 is equivalent to -c750228235959

. One or more non-numeric characters

can be used to separate the various 2-digit segments of the cutoff date (for example

-c77/2/2 9:22:25).

For 2-digit year input (

YY), the following interpretation is taken: [

70-99, 00-69

(1970-1999, 2000-2069)].

-a Requests printing of information for both removed, that is, delta type = R, (see

rmdel(1)) and existing, that is, delta type = D, deltas. If the -a option is not

speciﬁed, information is provided for existing deltas only.

If no option letters (or only

-a) are given, prs prints the ﬁle name using the default dataspec and the

-e option. This produces information on all deltas.

Data Keywords

Data keywords specify which parts of an SCCS ﬁle are to be retrieved and output. All parts of an SCCS

ﬁle (see sccsﬁle(4)) have an associated data keyword. There is no limit on the number of times a data

keyword can appear in a dataspec .

The information printed by prs consists of: (1) the user-supplied text; and (2) appropriate values

(extracted from the SCCS ﬁle) substituted for the recognized data keywords in the order of appearance in

the dataspec . The format of a data keyword value is either Simple (S), in which keyword substitution is

direct, or Multi-line (M), in which keyword substitution is followed by a carriage return.

User-supplied text is any text other than recognized data keywords. Escapes can be used as follows:

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
prs(1) prs(1) NAME prs - print and summarize an SCCS file SYNOPSIS prs [-d dataspec] [-r [SID] ] [-e] [-l] [-c cutoff] [-a] file ... DESCRIPTION The prs command prints, on the standard output, parts or all of an SCCS file (see sccsfile (4)) in a usersupplied format. If a directory is named, prs behaves as though each file in the directory were specified as a named file, except that non-SCCS files (last component of the path name does not begin with s.), and unreadable files are silently ignored.
PAGE 2
prs(1) prs(1) backslash backspace carriage return colon \\ \b \r \: form feed new-line single quote tab \f \n \’ \t The default dataspec is: ":Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:" A pA 2 Hewlett-Packard Company −2− HP-UX 11i Version 3: September 2010
PAGE 3
prs(1) prs(1) SCCS File Data Keywords Keyword :Dt: :DL: :Li: :Ld: :Lu: :DT: :I: :R: :L: :B: :S: :D: :Dy: :Dm: :Dd: :T: :Th: :Tm: :Ts: :P: :DS: :DP: :DI: :Dn: :Dx: :Dg: :MR: :C: :UN: :FL: :Y: :MF: :MP: :KF: :KV: :BF: :J: :LK: :Q: :M: :FB: :CB: :Ds: :ND: :FD: :BD: :GB: :W: :A: :Z: :F: :PN: Data Item Delta information Delta line statistics Lines inserted by Delta Lines deleted by Delta Lines unchanged by Delta Delta type SCCS ID string (SID) Release number Level number Branch number Sequence number Date De
PAGE 4
prs(1) prs(1) EXTERNAL INFLUENCES Environment Variables LC_CTYPE determines the interpretation of dataspec as single and/or multi-byte characters. LC_MESSAGES determines the language in which messages are displayed. If LC_CTYPE or LC_MESSAGES is not specified in the environment or is set to the empty string, the value of LANG is used as a default for each unspecified or empty variable. If LANG is not specified or is set to the empty string, a default of "C" (see lang (5)) is used instead of LANG.