Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
sccs-prs(1)			 User Commands			   sccs-prs(1)

       sccs-prs, prs - display selected	portions of an SCCS history

       /usr/ccs/bin/prs	 [-ael]	 [-cdate-time]	[-ddataspec]  [-rsid]  s.file-

       The prs utility displays	part or	all of the SCCS	file (see sccsfile(4))
       in a user supplied format.

       If  a  directory	 name is used in place of the s.filename argument, the
       prs command applies  to	all  s.files  in  that	directory.  Unreadable
       s.files	produce	 an error; processing continues	with the next file (if
       any). The use of	`-' as the  s.filename	argument  indicates  that  the
       names  of  files	are to be read from the	standard input,	one s.file per

       In the absence of options, prs displays the delta table (version	 log).
       In  the absence of -d, or -l, prs displays the entry for	each delta in-
       dicated by the other options.

       -a    Includes all deltas, including those marked as removed (see sccs-

       -e    Requests information for all deltas created earlier than, and in-
	     cluding, the delta	indicated with -r or -c.

       -l    Requests information for all deltas created later than,  and  in-
	     cluding, the delta	indicated with -r or -c.

	     Either  options  -e  or -l	must be	used with this option. -cdate-
	     time displays information on the deltas checked in	 either	 prior
	     to	and including the date and time	indicated by the date-time ar-
	     gument (option -e); or later than and including the date and time
	     indicated (option -l). date-time takes the	form:


	     Units  omitted  from the indicated	date and time default to their
	     maximum  possible	values;	 that  is  -c7502  is  equivalent   to
	     -c750228235959. Any number	of non-numeric characters may separate
	     the various 2 digit components.  If white-space characters	occur,
	     the  date-time  specification must	be quoted. Values of yy	in the
	     range 69-99 refer to the twentieth	century. Values	in  the	 range
	     of	00-68 refer to the twenty-first	century.

	     Produce  a	 report	according to the indicated data	specification.
	     dataspec consists of a (quoted) text string that includes	embed-
	     ded  data	keywords  of the form: `:key:' (see Data Keywords, be-
	     low). prs expands these keywords in the output  it	 produces.  To
	     specify  a	TAB character in the output, use \t; to	specify	a NEW-
	     LINE in the output, use \n.

       -rsid Specifies the SCCS	delta ID (SID) of the delta for	which informa-
	     tion  is desired. If no  SID is specified,	the most recently cre-
	     ated delta	is used.

   Data	Keywords
       Data keywords specify which parts of an SCCS file are to	be  retrieved.
       All  parts  of  an  SCCS	file (see sccsfile(4)) have an associated data
       keyword.	A data keyword may appear any number of	times in a data	speci-
       fication	 argument  to  -d. These data keywords are listed in the table

       Keyword		   Data	Item		 File Section*		     Value		  Format**
       :A:	 a format for the what string:	      N/A	 :Z::Y:	:M: :I::Z:		     S
       :B:	 branch	number			       D	 nnnn				     S
       :BD:	 body				       B	 text				     M
       :BF:	 branch	flag			       F	 yes or	no			     S
       :CB:	 ceiling boundary		       F	 :R:				     S
       :C:	 comments for delta		       D	 text				     M
       :D:	 date delta created		       D	 :Dy:/:Dm:/:Dd:			     S
       :Dd:	 day delta created		       D	 nn				     S
       :Dg:	 deltas	ignored	(seq #)		       D	 :DS: :DS:...			     S
       :DI:	 seq-no. of  deltas  included,	       D	 :Dn:/:Dx:/:Dg:			     S
		 excluded, ignored
       :DL:	 delta line statistics		       D	 :Li:/:Ld:/:Lu:			     S
       :Dm:	 month delta created		       D	 nn				     S
       :Dn:	 deltas	included (seq #)	       D	 :DS: :DS:...			     S
       :DP:	 predecessor delta seq-no.	       D	 nnnn				     S
       :Ds:	 default SID			       F	 :I:				     S
       :DS:	 delta sequence	number		       D	 nnnn				     S
       :Dt:	 delta information		      D		 :DT: :I: :D: :T: :P: :DS: :DP:	     S
       :DT:	 delta type			       D	 D or R				     S
       :Dx:	 deltas	excluded (seq #)	       D	 :DS: ...			     S
       :Dy:	 year delta created		       D	 nn				     S
       :F:	 s.file	name			      N/A	 text				     S
       :FB:	 floor boundary			       F	 :R:				     S
       :FD:	 file descriptive text		       C	 text				     M
       :FL:	 flag list			       F	 text				     M
       :GB:	 gotten	body			       B	 text				     M
       :I:	 SCCS delta ID (SID)		       D	 :R:.:L:.:B:.:S:		     S
       :J:	 joint edit flag		       F	 yes or	no			     S
       :KF:	 keyword error/warning flag	       F	 yes or	no			     S
       :L:	 level number			       D	 nnnn				     S
       :Ld:	 lines deleted by delta		       D	 nnnnn				     S
       :Li:	 lines inserted	by delta	       D	 nnnnn				     S
       :LK:	 locked	releases		       F	 :R:...				     S
       :Lu:	 lines unchanged by delta	       D	 nnnnn				     S
       :M:	 module	name			       F	 text				     S
       :MF:	 MR validation flag		       F	 yes or	no			     S
       :MP:	 MR validation program		       F	 text				     S
       :MR:	 MR numbers for	delta		       D	 text				     M
       :ND:	 null delta flag		       F	 yes or	no			     S
       :Q:	 user defined keyword		       F	 text				     S
       :P:	 user who created delta		       D	 username			     S
       :PN:	 s.file's pathname		      N/A	 text				     S
       :R:	 release number			       D	 nnnn				     S
       :S:	 sequence number		       D	 nnnn				     S
       :T:	 time delta created		       D	 :Th:::Tm:::Ts:			     S
       :Th:	 hour delta created		       D	 nn				     S
       :Tm:	 minutes delta created		       D	 nn				     S
       :Ts:	 seconds delta created		       D	 nn				     S
       :UN:	 user names			       U	 text				     M
       :W:	 a form	of what	string		      N/A	 :Z::M:\t:I:			     S
       :Y:	 module	type flag		       F	 text				     S
       :Z:	 what string delimiter		      N/A	 @(#)				     S

	      *B  =  body,  D  =  delta	 table,	 F  =  flags,  U  = user names

       **S = simple format, M =	multi-line format

       Example 1: Displaying delta entries

       The following command:

       example%	/usr/ccs/bin/prs -e -d":I:\t:P:" program.c

       1.6    username
       1.5 username...

	     temporary file

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWsprot			   |

       sccs(1),	sccs-cdc(1), sccs-delta(1), sccs-get(1),  sccs-help(1),	 sccs-
       prt(1),	 sccs-sact(1),	sccs-sccsdiff(1),  what(1),  sccsfile(4),  at-

       Use the SCCS help command for explanations (see sccs-help(1)).

SunOS 5.9			  1 Nov	1999			   sccs-prs(1)


Want to link to this manual page? Use this URL:

home | help