Content-type: text/html Man page of prs

prs

Section: User Commands (1)
Index Return to Main Contents
 

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:  XPG4, XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.
 

OPTIONS

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. 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"
[Compaq]  If the year (yy) field is less than 69, prs interprets it as being in the twenty-first century, i.e. 20yy. If the year is greater than or equal to 69, prs interprets it as being in the twentieth century, i.e. 19yy. 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). Requests information for all deltas created earlier than (and including) the delta specified by the -r option. Requests information for all deltas created later than (and including) the delta specified by the -r option. 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

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


KeywordData RepresentedValueFormat

:R:Release numbernumSimple
:L:Level numbernumSimple
:B:Branch numbernumSimple
:S:Sequence numbernumSimple
:I: SCCS ID string (SID) :R::L::B::S:Simple
:Dy: Year delta created YYSimple
:Dm: Month delta created MMSimple
:Dd:Day delta createdDDSimple
:D: Date delta created YY/MM/DDSimple
:Th: Hour delta created HHSimple
:Tm: Minute delta created MMSimple
:Ts: Second delta created SSSimple
:T: Time delta created HH/MM/SSSimple
:DT: Delta type~D or R~Simple
:P: User who created the delta login nameSimple
:DS: Delta sequence number numSimple
:DP: Previous delta sequence number numSimple
:Dt:Delta information :DT::I::D: :T::P::DS::DP: Simple
:Dn: Sequence numbers of deltas included :DS:...Simple
:Dx: Sequence numbers of deltas excluded :DS:...Simple
:Dg: Sequence numbers of deltas ignored :DS:...Simple
:DI: Sequence numbers of deltas included, excluded, and ignored :Dn:/:Dx:/:Dg:Simple
:Li: Lines inserted by Delta numSimple
:Ld: Lines deleted by Delta numSimple
:Lu: Lines unchanged by Delta numSimple
:DL: Delta line statistics :Li:/:Ld:/:Lu:Simple
:MR: MR numbers for delta textMultiline
:C: Comments for delta textMultiline

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


KeywordData RepresentedValueFormat

:Y:Module typetextSimple
:MF: MR validation flag set yes or noSimple
:MP: MR validation program name textSimple
:KF: Keyword/error warning flag set yes or noSimple
:KV: Keyword validation string textSimple
:BF:Branch flag setyes or noSimple
:J: Joint edit flag set yes or noSimple
:LK:Locked releases:R:...Simple
:Q: User-defined keyword textSimple
:M:Module nametextSimple
:FB:Floor boundary:R:Simple
:CB:Ceiling boundary:R:Simple
:Ds:Default SID:I:Simple
:ND: Null delta flag set yes or noSimple
:FL:Header flag listtextMultiline

The following table lists the keywords associated with other parts of the SCCS file.
 

Other Keywords


KeywordData RepresentedValueFormat

:UN:UsernamestextMultiline
:FD:Descriptive texttextMultiline
:BD:Body of texttextMultiline
:GB:Text in a g-filetextMultiline
:W: what string :Z::M: <Tab> :I: Simple
:A: what string :Z::Y::M::I::Z:Simple
:Z: what string delimiter @(#)Simple
:F:SCCS file nametextSimple
:PN: SCCS file path name textSimple


 

EXIT STATUS

The following exit values are returned: Successful completion. An error occurred.
 

EXAMPLES

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 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: 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. If set to a non-empty string value, overrides the values of all the other internationalization variables. 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). Determines the locale for the format and contents of diagnostic messages written to standard error. Determines the location of message catalogues for the processing of LC_MESSAGES.
 

FILES

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

NAME
SYNOPSIS
STANDARDS
OPTIONS
OPERANDS
DESCRIPTION
Data Keywords
Delta Table Keywords
Header Flag Keywords
Other Keywords
EXIT STATUS
EXAMPLES
ENVIRONMENT VARIABLES
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:51 GMT, October 02, 2010