prs(1)							      General Commands Manual							    prs(1)

NAME

       prs - print and summarize an SCCS file

SYNOPSIS

       dataspec] [SID]] cutoff] file ...

DESCRIPTION

       The  command  prints,  on the standard output, parts or all of an SCCS file (see sccsfile(4)) in a user-supplied format.  If a directory is
       named, behaves as though each file in the directory were specified as a named file, except that non-SCCS files (last component of the  path
       name  does  not	begin with 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 or directory to be processed; non-SCCS  files  and  unreadable  files  are  silently
       ignored.  A on the command line implies that all following arguments are file/directory names.

       Arguments to which can appear in any order, consist of options and file names.

   Options
       All of the described options apply independently to each named file:

	      Used to specify the output data specification.
			     dataspec is a string consisting of SCCS file data keywords (see Data Keywords below) interspersed with optional user-
			     supplied text.

	      Used to specify the
			     SCCS IDentification (SID) string of a delta for which information is desired.  If no SID is specified, the SID of the
			     most  recently created delta is assumed.  If an SID is specified, it must agree exactly with an SID in the file (that
			     is, the SID structure used by does not work here -- see get(1)).

	      Requests information for all deltas created
			     than and including the delta designated via the option or the date given by the option.

	      Requests information for all deltas created
			     than and including the delta designated via the option or the date given by the option.

	      Cutoff date-time, in the form

				    YY[MM[DD[HH[MM[SS]]]]]

			     Units omitted from the date-time default to their maximum possible values.  Thus, is equivalent to One or	more  non-
			     numeric characters can be used to separate the various 2-digit segments of the cutoff date (for example

			     For 2-digit year input the following interpretation is taken:

	      Requests printing of information for both removed,
			     that  is,	delta type = R, (see rmdel(1)) and existing, that is, delta type = D, deltas.  If the option is not speci-
			     fied, information is provided for existing deltas only.

       If no option letters (or only are given, prints the file name using the default dataspec and the option.  This produces information on  all
       deltas.

   Data Keywords
       Data  keywords  specify	which  parts  of an SCCS file are to be retrieved and output.  All parts of an SCCS file (see sccsfile(4)) have an
       associated data keyword.  There is no limit on the number of times a data keyword can appear in a dataspec.

       The information printed by consists of: (1) the user-supplied text; and (2) appropriate values (extracted from the SCCS	file)  substituted
       for  the  recognized  data keywords in the order of appearance in the dataspec.	The format of a data keyword value is either (S), in which
       keyword substitution is direct, or (M), in which keyword substitution is followed by a carriage return.

       User-supplied text is any text other than recognized data keywords.  Escapes can be used as follows:

	      backslash 	\   form feed	    f
	      backspace 	   new-line	    


	      carriage return	
   single quote   '
	      colon		:   tab	    	

       The default dataspec is:

								SCCS File Data Keywords
										 File
				     Keyword   Data Item			Section 	  Value 	Fmt
				     -------------------------------------------------------------------------------
				      :Dt:     Delta information	      Delta Table      See below*	 S
				      :DL:     Delta line statistics		   "	     :Li:/:Ld:/:Lu:	 S
				      :Li:     Lines inserted by Delta		   "		  nnnnn 	 S
				      :Ld:     Lines deleted by Delta		   "		  nnnnn 	 S
				      :Lu:     Lines unchanged by Delta 	   "		  nnnnn 	 S
				      :DT:     Delta type			   "		 D or R 	 S
				       :I:     SCCS ID string (SID)		   "	     :R:.:L:.:B:.:S:	 S
				       :R:     Release number			   "		  nnnn		 S
				       :L:     Level number			   "		  nnnn		 S
				       :B:     Branch number			   "		  nnnn		 S
				       :S:     Sequence number			   "		  nnnn		 S
				       :D:     Date Delta created		   "	     :Dy:/:Dm:/:Dd:	 S
				      :Dy:     Year Delta created		   "		   nn		 S
				      :Dm:     Month Delta created		   "		   nn		 S
				      :Dd:     Day Delta created		   "		   nn		 S
				       :T:     Time Delta created		   "	     :Th:::Tm:::Ts:	 S
				      :Th:     Hour Delta created		   "		   nn		 S
				      :Tm:     Minutes Delta created		   "		   nn		 S
				      :Ts:     Seconds Delta created		   "		   nn		 S
				       :P:     Programmer who created Delta	   "		 logname	 S
				      :DS:     Delta sequence number		   "		  nnnn		 S
				      :DP:     Predecessor Delta seq-no.	   "		  nnnn		 S
				      :DI:     Seq # of deltas incl,  excl,	   "	     :Dn:/:Dx:/:Dg:	 S
					       ign
				      :Dn:     Deltas included (seq #)		   "	      :DS: :DS:...	 S
				      :Dx:     Deltas excluded (seq #)		   "	      :DS: :DS:...	 S
				      :Dg:     Deltas ignored (seq #)		   "	      :DS: :DS:...	 S
				      :MR:     MR numbers for delta		   "		  text		 M
				       :C:     Comments for delta		   "		  text		 M
				      :UN:     User names		       User name	  text		 M
				      :FL:     Flag list			 Flags		  text		 M
				       :Y:     Module type flag 		   "		  text		 S
				      :MF:     MR validation flag		   "		yes or no	 S
				      :MP:     MR validation pgm name		   "		  text		 S
				      :KF:     Keyword error/warning flag	   "		yes or no	 S
				      :KV:     Keyword validation string	   "		  text		 S
				      :BF:     Branch flag			   "		yes or no	 S
				       :J:     Joint edit flag			   "		yes or no	 S
				      :LK:     Locked releases			   "		 :R:... 	 S
				       :Q:     User defined keyword		   "		  text		 S
				       :M:     Module name			   "		  text		 S
				      :FB:     Floor boundary			   "		   :R:		 S
				      :CB:     Ceiling boundary 		   "		   :R:		 S
				      :Ds:     Default SID			   "		   :I:		 S
				      :ND:     Null delta flag			   "		yes or no	 S
				      :FD:     File descriptive text	       Comments 	  text		 M
				      :BD:     Body				 Body		  text		 M
				      :GB:     Gotten body			   "		  text		 M
				       :W:     A form of what(1) string 	  N/A	       :Z::M:	:I:	 S
				       :A:     A form of what(1) string 	  N/A	    :Z::Y: :M: :I::Z:	 S
				       :Z:     what(1) string delimiter 	  N/A		  @(#)		 S
				       :F:     SCCS file name			  N/A		  text		 S
				      :PN:     SCCS file path name		  N/A		  text		 S

       If  no option letters (or only are given, prints the file name, using the default dataspec, and the option; thus, information on all deltas
       is produced.

EXTERNAL INFLUENCES

   Environment Variables
       determines the interpretation of dataspec as single and/or multi-byte characters.

       determines the language in which messages are displayed.

       If or is not specified in the environment or is set to the empty string, the value of is used as a default for each  unspecified  or  empty
       variable.  If is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of If any internationalization
       variable contains an invalid setting, behaves as if all internationalization variables are set to "C".  See environ(5).

   International Code Set Support
       Single-byte and multi-byte character code sets are supported.

DIAGNOSTICS

       See sccshelp(1) for explanations.

EXAMPLES

       The entry

       may produce on the standard output:

       The entry

       may produce on the standard output:

       As a (when no specifications for selecting or printing are given)

       may produce on the standard output:

       for each delta table entry of the "D" type.  The only option argument allowed to be used with the is the option.

FILES

SEE ALSO

       admin(1), delta(1), get(1), sccshelp(1), sccsfile(4).

STANDARDS CONFORMANCE

																	    prs(1)