PWB1/usr/man/man1/prt.1
.tr ~
.if n .ds D " --
.if t .ds D _
.tr @|
.if n .tr #-
.if t .tr #\(em
.de SP
.if n .ul
[\fB#\\$1\fR\\c
.if n .ul 0
\\$2\\$3
..
.de SF
.if n .ul
[\fB#\\$1\fR]
.if n .ul 0
..
.de DT
.hc ^
^...
.hc
..
.de AR
.s1
.lp +10 5
\fB#\\$1\\fR \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
..
.de FI
.s1
.lp +30 30
\\$1 \\$2
.i0
..
.ds F) \fB\s-2FILES\s+2\fR
.de I
.if n .ul
\fI\\$1\fR\c
.if n .ul 0
\\$2\\$3\\$4\\$5\\$6\\$7\\$8\\$9
..
.if n .ds )Q '
.if n .ds )G `
.if t .ds )Q \\(aa
.if t .ds )G \\(ga
.if t .ds )S \\|
.th PRT I 8/31/77
.sh NAME
prt \*- print SCCS file
.sh SYNOPSIS
.na
.bd prt
.SF d
.SF s
.SF a
.SF i
.SF u
.SF f
.SF t
.SF b
.SF e
.SP y [SID]]
.br
.SP c [cutoff]]
.SP r [reverse-cutoff]]
name
.DT
.ad
.sh DESCRIPTION
.it Prt
prints part or all of an SCCS file in a useful format.
If a directory is named,
.it prt
behaves as though each file in the directory were
specified as a named file,
except that non-SCCS files
(last component of the pathname does not begin with ``s\fB.\fP''),
and unreadable files
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 file
to be processed.
Again, non-SCCS files and unreadable files are silently ignored.
.s1
The keyletter arguments are as follows.
Each is explained as though only one named file is to be processed,
but the effects of any keyletter argument
apply independently to
each named file.
.AR d This
keyletter normally causes the printing of delta table entries of the
``D'' type.
.AR s Causes
only the first line of the delta table entries to be printed; that is,
only up to the statistics.
This keyletter is effective only if the
.bd d
keyletter is also specified (or assumed).
.AR a Causes
those types of deltas normally not printed by the
.bd d
keyletter to be printed. These are types ``R'' (removed).
This keyletter is effective only if the
.bd d
keyletter is also specified (or assumed).
.AR i Causes
the printing of the serial numbers of those deltas included,
excluded, and ignored.
This keyletter is effective only if the
.bd d
keyletter is also specified (or assumed).
.in -5
.s1
The following format is used to print those
portions of the SCCS file as specified by the above keyletters.
The printing of each delta table entry
is
preceded
by a newline character.
.s1
.lp +13 3
a) Type of delta (``D'' or ``R'').
.lp +13 3
b) Space.
.lp +13 3
c) SCCS identification string (SID).
.lp +13 3
d) Tab.
.lp +13 3
e) Date and time of creation.
.br
(in the form YY/MM/DD HH:MM:SS)
.lp +13 3
f) Tab.
.lp +13 3
g) Creator.
.lp +13 3
h) Tab.
.lp +13 3
i) Serial number.
.lp +13 3
.lp +13 3
j) Tab.
.lp +13 3
k) Predecessor delta's serial number.
.lp +13 3
l) Tab.
.lp +13 3
m) Statistics.
.br
(in the form inserted/deleted/unchanged)
.lp +13 3
n) Newline.
.lp +13 3
o) ``Included:\c
.ul
tab'',
.ul 0
followed by SID's of deltas included, followed by
newline (only if there were any such deltas and if
.bd i
keyletter was supplied).
.lp +13 3
p) ``Excluded:\c
.ul
tab'',
.ul 0
followed by SID's of deltas excluded, followed by
newline (see note above).
.lp +13 3
q) ``Ignored:\c
.ul
tab'',
.ul 0
followed by SID's of deltas ignored, followed by
newline (see note above).
.lp +13 3
r) ``MRs:\c
.ul
tab'',
.ul 0
followed by MR numbers related to the delta, followed by
newline (only if any MR numbers were supplied).
.lp +13 3
s) Lines of comments (history), followed by newline
(if any were supplied).
.in +5
.AR u Causes
the printing of the login-names of those users allowed to make
deltas.
.AR f Causes
the printing of the flags of the named file.
.AR t Causes
the printing of the descriptive text
contained in the file.
.AR b Causes
the printing of the body of the SCCS file.
.AR e This
keyletter implies the
.bd d\c
,
.bd i\c
,
.bd u\c
,
.bd f\c
,
and
.bd t
keyletters and is provided for convenience.
.AR y This
keyletter will cause the printing of the delta table entries to stop
when the delta just printed has the specified SID.
If no delta in the table has the specified SID, the entire table is
printed.
If no SID is specified, the first delta in the delta table is printed.
This keyletter will cause the entire delta table entry for each delta to be
printed as a single line (the newlines in the normal multi-line format
of the
.bd d
keyletter are replaced by blanks)
preceded by the name of the SCCS file being processed, followed by a ``:'',
followed by a tab.
This keyletter
is effective only if the
.bd d
keyletter is also specified (or assumed).
.AR c This
keyletter will cause the printing of the delta table entries
to stop if the delta about to be printed is older than the
specified cutoff date-time (see
.it get\c
(I)
for the format of date-time).
If no date-time is supplied, the
epoch 0000 GMT Jan. 1, 1970 is used.
As with the
.bd y
keyletter, this keyletter will cause the entire delta table
entry to be printed as a single line and
to be preceded by the name of the SCCS file being processed,
followed by a ``:'', followed by a tab.
This keyletter is effective only if the
.bd d
keyletter is also specified (or assumed).
.AR r This
keyletter will cause the printing of the delta table entries
to begin when the delta about to be printed is older than or equal to the
specified cutoff date-time (see
.it get\c
(I)
for the format of date-time).
If no date-time is supplied, the
epoch 0000 GMT Jan. 1, 1970 is used.
(In this case, nothing will be printed).
As with the
.bd y
keyletter, this keyletter will cause the entire delta table
entry to be printed as a single line and
to be preceded by the name of the SCCS file being processed,
followed by a ``:'', followed by a tab.
This keyletter is effective only if the
.bd d
keyletter is also specified (or assumed).
.i0
.s1
If any keyletter but
.bd y\c
,
.bd c\c
,
or
.bd r
is supplied, the name of the file being processed (preceded by one newline
and followed by two newlines) is printed before its contents.
.s1
If none of the
.bd u
,
.bd f
,
.bd t
,
or
.bd b
keyletters is supplied, the
.bd d
keyletter is assumed.
.s1
Note that the
.bd s
and
.bd i
keyletters, and the
.bd c
and
.bd r
keyletters are mutually exclusive;
therefore, they may not be specified together on the same
.it prt
command.
.s1
The form of the delta table
as produced by the
.bd y\c
,
.bd c\c
,
and
.bd r
keyletters makes it easy to sort multiple delta tables by time order.
For example,
the following will print the delta tables of all SCCS files
in directory
.it sccs
in reverse chronological order:
.s3
.ti +4
.if t prt #c sccs @ grep \fB.\fR @ sort \*()Q#rt\fItab\fP\*()Q +2 #3
.if n prt -c sccs @ grep . @ sort \*()Q-rt<tab>\*()Q +2 #3
.br
.s1
When both the
.bd y
and
.bd c
or the
.bd y
and
.bd r
keyletters are supplied,
.it prt
will stop printing when the first of the two conditions is met.
.s1
The
.it reform\c
(I)
command can be used to truncate long lines.
.s1
See
.it admin\c
(I),
.it sccsfile\c
(V),
and
.it "SCCS/PWB User's Manual"
for more information about the meaning of the output of
.it prt.
.sh "SEE ALSO"
admin(I),
get(I),
delta(I),
what(I),
help(I),
sccsfile(V)
.br
.it "SCCS/PWB User's Manual"
by L. E. Bonanni and A. L. Glasser.
.sh DIAGNOSTICS
Use
.it help\c
(I)
for explanations.
\" @(#)prt.1 4.8
.tr ~~
.tr @@