prs(1) — Commands
NAME
prs − Displays key information in a Source Code Control System (SCCS) file
SYNOPSIS
prs [-a] [-ddataspec] [-r [-rSID]] file
prs [-e| [-l] [-ccutoff] [-ddataspec] file...
prs[-e| -l] -rSID [-ddataspec] file ...
FLAGS
Each flag or group of flags applies independently to each named file.
-aWrites information for the specified deltas, whether or not they were removed (see the rmdel command). If you do not specify the -a flag, prs supplies information only for the specified deltas that were not removed.
-c cutoffSpecifies a cutoff date and time for the -e and -l flags. 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"
-d dataspec
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).
-eRequests information for all deltas created earlier than (and including) the delta specified by the -r flag.
-lRequests information for all deltas created later than (and including) the delta specified by the -r flag.
-r[SID]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.
DESCRIPTION
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.
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 file reference page for information about file structure).
Delta Table Keywords
| Keyword | Data Represented | Value | Format |
| :R: | Release number | num | Simple |
| :L: | Level number | num | Simple |
| :B: | Branch number | num | Simple |
| :S: | Sequence number | num | Simple |
| :I: | SCCS ID string (SID) | :R::L::B::S: | Simple |
| :Dy: | Year delta created | YY | Simple |
| :Dm: | Month delta created | MM | Simple |
| :Dd: | Day delta created | DD | Simple |
| :D: | Date delta created | YY/MM/DD | Simple |
| :Th: | Hour delta created | HH | Simple |
| :Tm: | Minute delta created | MM | Simple |
| :Ts: | Second delta created | SS | Simple |
| :T: | Time delta created | HH/MM/SS | Simple |
| :DT: | Delta type~D or R~Simple | ||
| :P: | User who created the | login name | Simple |
| delta | |||
| :DS: | Delta sequence number | num | Simple |
| :DP: | Previous delta | num | Simple |
| sequence number | |||
| :Dt: | Delta information | :DT::I::D: :T::P::DS::DP: | Simple |
| :Dn: | Sequence numbers of | :DS:... | Simple |
| deltas included | |||
| :Dx: | Sequence numbers of | :DS:... | Simple |
| deltas excluded | |||
| :Dg: | Sequence numbers of | :DS:... | Simple |
| deltas ignored | |||
| :DI: | Sequence numbers of | :Dn:/:Dx:/:Dg: | Simple |
| deltas included | |||
| excluded, and ignored | |||
| :Li: | Lines inserted by Delta | num | Simple |
| :Ld: | Lines deleted by Delta | num | Simple |
| :Lu: | Lines unchanged by Delta | num | Simple |
| :DL: | Delta line statistics | :Li:/:Ld:/:Lu: | Simple |
| :MR: | MR numbers for delta | text | Multiline |
| :C: | Comments for delta | text | Multiline |
The following table lists the keywords associated with the header flags in the SCCS file. For more information on header flags, see the admin command.
Header Flag Keywords
| Keyword | Data Represented | Value | Format |
| :Y: | Module type | text | Simple |
| :MF: | MR validation flag set | yes or no | Simple |
| :MP: | MR validation program name | text | Simple |
| :KF: | Keyword/error warning flag set | yes or no | Simple |
| :KV: | Keyword validation string | text | Simple |
| :BF: | Branch flag set | yes or no | Simple |
| :J: | Joint edit flag set | yes or no | Simple |
| :LK: | Locked releases | :R:... | Simple |
| :Q: | User-defined keyword | text | Simple |
| :M: | Module name | text | Simple |
| :FB: | Floor boundary | :R: | Simple |
| :CB: | Ceiling boundary | :R: | Simple |
| :Ds: | Default SID | :I: | Simple |
| :ND: | Null delta flag set | yes or no | Simple |
| :FL: | Header flag list | text | Multiline |
The following table lists the keywords associated with other parts of the SCCS file.
Other Keywords
| Keyword | Data Represented | Value | Format |
| :UN: | Usernames | text | Multiline |
| :FD: | Descriptive text | text | Multiline |
| :BD: | Body of text | text | Multiline |
| :GB: | Text in a g-file | text | Multiline |
| :W: | what string | :Z::M: <Tab> :I: | Simple |
| :A: | what string | :Z::Y::M::I::Z: | Simple |
| :Z: | what string delimiter | @(#) | Simple |
| :F: | SCCS filename | text | Simple |
| :PN: | SCCS file pathname | text | Simple |
EXAMPLES
1.To display information on all deltas generated for SCCS filename s.test.c (including all deltas removed using rmdel), enter:
prs -a s.test.c
2.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
FILES
/tmp/pr?????Temporary files.
RELATED INFORMATION
Commands: admin(1), cdc(1), comb(1), delta(1), get(1), rmdel(1), sact(1), sccsdiff(1), sccshelp(1), unget(1), val(1), what(1).
Files: sccsfile(4).