'\" te
.\" Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
.TH sccs-prs 1 "22 Mar 2011" "SunOS 5.11" "User Commands"
.SH NAME
sccs-prs, prs \- display selected portions of an SCCS history
.SH SYNOPSIS
.LP
.nf
\fBprs\fR [\fB-ael\fR] [\fB-c\fR\fIdate-time\fR] [\fB-d\fR\fIdataspec\fR] [\fB-r\fR\fIsid\fR] \fIs.filename\fR...
.fi

.SH DESCRIPTION
.sp
.LP
The \fBprs\fR utility displays part or all of the \fBSCCS\fR file (see \fBsccsfile\fR(4)) in a user supplied format.
.sp
.LP
If a directory name is used in place of the \fIs.filename\fR argument, the \fBprs\fR command applies to all \fBs.\fRfiles in that directory. Unreadable \fBs.\fRfiles produce an error; processing continues with the next file (if any). The use of `\fB\(mi\fR\&' as the \fIs.filename\fR argument indicates that the names of files are to be read from the standard input, one \fBs.\fRfile per line.
.SH OPTIONS
.sp
.LP
In the absence of options, \fBprs\fR displays the delta table (version log). In the absence of \fB-d\fR, or \fB-l\fR, \fBprs\fR displays the entry for each delta indicated by the other options.
.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.RS 15n
.rt  
Includes all deltas, including those marked as removed (see \fBsccs-rmdel\fR(1)). 
.RE

.sp
.ne 2
.mk
.na
\fB\fB-e\fR\fR
.ad
.RS 15n
.rt  
Requests information for all deltas created \fIearlier\fR than, and including, the delta indicated with \fB-r\fR or \fB-c\fR. 
.RE

.sp
.ne 2
.mk
.na
\fB\fB-l\fR\fR
.ad
.RS 15n
.rt  
Requests information for all deltas created \fIlater\fR than, and including, the delta indicated with \fB-r\fR or \fB-c\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-c\fR\fIdate-time\fR\fR
.ad
.RS 15n
.rt  
Either options \fB-e\fRor \fB-l\fRmust be used with this option. \fB-c\fR\fIdate-time\fR displays information on the deltas checked in either prior to and including the date and time indicated by the \fIdate-time\fR argument (option \fB-e\fR); or later than and including the date and time indicated (option \fB-l\fR). \fIdate-time\fR takes the form:
.sp
\fIyy\fR[\fImm\fR[\fIdd\fR[\fIhh\fR[\fImm\fR[\fIss\fR]\|]\|]\|]\|]
.sp
Units omitted from the indicated date and time default to their maximum possible values; that is \fB-c\fR\fB7502\fR is equivalent to \fB-c\fR\fB750228235959\fR. Any number of non-numeric characters may separate the various 2 digit components. If white-space characters occur, the \fIdate-time\fR specification must be quoted. Values of \fIyy\fR in the range \fB69\(mi99\fR refer to the twentieth century. Values in the range of \fB00\(mi68\fR refer to the twenty-first century.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-d\fR\fIdataspec\fR\fR
.ad
.RS 15n
.rt  
Produce a report according to the indicated data specification. \fIdataspec\fR consists of a (quoted) text string that includes embedded data keywords of the form: `\fB:\fR\fIkey\fR\fB:\fR' (see \fBData Keywords\fR, below). \fBprs\fR expands these keywords in the output it produces. To specify a \fBTAB\fR character in the output, use \fB\et\fR; to specify a NEWLINE in the output, use \fB\en\fR\&. 
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR\fIsid\fR\fR
.ad
.RS 15n
.rt  
Specifies the \fBSCCS\fR delta \fBID\fR (\fBSID\fR) of the delta for which information is desired. If no  \fBSID\fR is specified, the most recently created delta is used.
.RE

.SH USAGE
.sp
.LP
Usage of \fBprs\fR is described below.
.SS "Data Keywords"
.sp
.LP
Data keywords specify which parts of an \fBSCCS\fR file are to be retrieved. All parts of an \fBSCCS\fR file (see \fBsccsfile\fR(4)) have an associated data keyword. A data keyword may appear any number of times in a data specification argument to \fB-d\fR. These data keywords are listed in the table below: 
.sp
.in +2
.nf

.fi
.in -2
.sp

.sp

.sp
.TS
tab();
cw(.65i) cw(1.94i) cw(.65i) cw(1.62i) cw(.65i) 
lw(.65i) lw(1.94i) lw(.65i) lw(1.62i) lw(.65i) 
.
\fIKeyword\fR\fIData Item\fR\fIFile Section*\fR\fIValue\fR\fIFormat\fR**
\fB:A:\fRa format for the \fBwhat\fR string:N/A\fB:Z::Y: :M: :I::Z:\fRS
\fB:B:\fRbranch numberD\fInnnn\fRS
\fB:BD:\fRbodyB\fItext\fRM
\fB:BF:\fRbranch flagF\fByes\fR or \fBno\fRS
\fB:CB:\fRceiling boundaryF\fB:R:\fRS
\fB:C:\fRcomments for deltaD\fItext\fRM
\fB:D:\fRdate delta createdD\fB:Dy:/:Dm:/:Dd:\fRS
\fB:Dd:\fRday delta createdD\fInn\fRS
\fB:Dg:\fRdeltas ignored (seq #)D\fB:DS: :DS:\fR\|.\|.\|.S
\fB:DI:\fRT{
seq-no. of deltas included, excluded, ignored
T}D\fB:Dn:/:Dx:/:Dg:\fRS
\fB:DL:\fRdelta line statisticsD\fB:Li:/:Ld:/:Lu:\fRS
\fB:Dm:\fRmonth delta createdD\fInn\fRS
\fB:Dn:\fRdeltas included (seq #)D\fB:DS: :DS:\fR\|.\|.\|.S
\fB:DP:\fRpredecessor delta seq-no. D\fInnnn\fRS
\fB:Ds:\fRdefault SIDF\fB:I:\fRS
\fB:DS:\fRdelta sequence numberD\fInnnn\fRS
\fB:Dt:\fRdelta informationD \fB:DT: :I: :D: :T: :P: :DS: :DP:\fRS
\fB:DT:\fRdelta typeD\fBD\fR or \fBR\fRS
\fB:Dx:\fRdeltas excluded (seq #)D\fB:DS:\fR \|.\|.\|.S
\fB:Dy:\fRyear delta createdD\fInn\fRS
\fB:F:\fR\fBs.\fRfile nameN/A\fItext\fRS
\fB:FB:\fRfloor boundaryF\fB:R:\fRS
\fB:FD:\fRfile descriptive textC\fItext\fRM
\fB:FL:\fRflag listF\fItext\fRM
\fB:GB:\fRgotten bodyB\fItext\fRM
\fB:I:\fRSCCS delta ID (SID)D\fB:R:.:L:.:B:.:S:\fRS
\fB:J:\fRjoint edit flagF\fByes\fR or \fBno\fRS
\fB:KF:\fRkeyword error/warning flagF\fByes\fR or \fBno\fRS
\fB:L:\fRlevel numberD\fInnnn\fRS
\fB:Ld:\fRlines deleted by deltaD\fInnnnn\fRS
\fB:Li:\fRlines inserted by deltaD\fInnnnn\fRS
\fB:LK:\fRlocked releasesF\fB:R:\fR\|.\|.\|.S
\fB:Lu:\fRlines unchanged by deltaD\fInnnnn\fRS
\fB:M:\fRmodule nameF\fItext\fRS
\fB:MF:\fRMR validation flagF\fByes\fR or \fBno\fRS
\fB:MP:\fRMR validation programF\fItext\fRS
\fB:MR:\fRMR numbers for deltaD\fItext\fRM
\fB:ND:\fRnull delta flagF\fByes\fR or \fBno\fRS
\fB:Q:\fRuser defined keywordF\fItext\fRS
\fB:P:\fRuser who created deltaD\fIusername\fRS
\fB:PN:\fR\fBs.\fRfile's pathnameN/A\fItext\fRS
\fB:R:\fRrelease numberD\fInnnn\fRS
\fB:S:\fRsequence numberD\fInnnn\fRS
\fB:T:\fRtime delta createdD\fB:Th:::Tm:::Ts:\fRS
\fB:Th:\fRhour delta createdD\fInn\fRS
\fB:Tm:\fRminutes delta createdD\fInn\fRS
\fB:Ts:\fRseconds delta createdD\fInn\fRS
\fB:UN:\fRuser namesU\fItext\fRM
\fB:W:\fRa form of \fBwhat\fR stringN/A\fB:Z::M:\et:I:\fRS
\fB:Y:\fRmodule type flagF\fItext\fRS
\fB:Z:\fR\fBwhat\fR string delimiterN/A\fB@(#)\fRS
.TE

.sp
.LP
*B = body, D = delta table, F = flags, U = user names
.sp
.LP
**S = simple format, M = multi-line format
.SH EXAMPLES
.LP
\fBExample 1 \fRDisplaying delta entries
.sp
.LP
The following command displays delta entries:

.sp
.in +2
.nf
example% \fBprs -e -d":I:\et:P:" program.c\fR
.fi
.in -2
.sp

.sp
.LP
produces:

.sp
.in +2
.nf
1.6	username
1.5 username...
.fi
.in -2
.sp

.SH ENVIRONMENT VARIABLES
.sp
.LP
See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBprs\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
.SH FILES
.sp
.ne 2
.mk
.na
\fB\fB/tmp/pr?????\fR\fR
.ad
.RS 16n
.rt  
temporary file
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitydeveloper/build/make
_
Interface StabilityCommitted
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBsccs\fR(1), \fBsccs-cdc\fR(1), \fBsccs-delta\fR(1), \fBsccs-get\fR(1), \fBsccs-help\fR(1), \fBsccs-prt\fR(1), \fBsccs-sact\fR(1), \fBsccs-sccsdiff\fR(1), \fBwhat\fR(1), \fBsccsfile\fR(4), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)
.SH DIAGNOSTICS
.sp
.LP
Use the \fBsccs-help\fR command for explanations of SCCS commands. See \fBsccs-help\fR(1).