


      PRS(1)			  (UNIX	5.0)			 PRS(1)



      NAME
	   prs - print an SCCS file

      SYNTAX
	   prs [-d[dataspec]] [-r[SID]]	[-e] [-l] [-a] files

      DESCRIPTION
	   Prs 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, prs 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	s.), 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.

	   Arguments to	prs, which may appear in any order, consist of
	   keyletter arguments,	and file names.

	   All the described keyletter arguments apply independently to
	   each	named file:

		-d[dataspec]   Used to specify the output data
			       specification.  The dataspec is a string
			       consisting of SCCS file data keywords
			       (see DATA KEYWORDS) interspersed	with
			       optional	user supplied text.

		-r[SID]	       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.

		-e	       Requests	information for	all deltas
			       created earlier than and	including the
			       delta designated	via the	-r keyletter.

		-l	       Requests	information for	all deltas
			       created later than and including	the
			       delta designated	via the	-r keyletter.

		-a	       Requests	printing of information	for
			       both removed, i.e., delta type =	R, (see
			       rmdel(1)) and existing, i.e., delta type
			       = D, deltas.  If	the -a keyletter is not
			       specified, information for existing
			       deltas only is provided.

      DATA KEYWORDS



      Page 1					      (73 A2 02MT REV1)






      PRS(1)			  (UNIX	5.0)			 PRS(1)



	   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 may appear in a
	   dataspec.

	   The information printed by prs 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 Simple (S),	in
	   which keyword substitution is direct, or Multi-line (M), in
	   which keyword substitution is followed by a carriage	return.

	   User-supplied text is any text other	than recognized	data
	   keywords.  A	tab is specified by \t and carriage
	   return/new-line is specified	by \n.






































      Page 2					      (73 A2 02MT REV1)






      PRS(1)			  (UNIX	5.0)			 PRS(1)



			     TABLE 1. SCCS Files Data Keywords
      KeywordData Item				  File Section	    Value      Format
       :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-no. of	deltas incl., excl.,	       "       :Dn:/:Dx:/:Dg:	 S
	     ignored
       :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	Names	    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
       :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:\t:I:	 S
	:A:  A form of what(1) string		      N/A     :Z::Y: :M: :I::Z:	 S




      Page 3					      (73 A2 02MT REV1)






      PRS(1)			  (UNIX	5.0)			 PRS(1)



	: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

	     * :Dt: = :DT: :I: :D: :T: :P: :DS:	:D
	 :

















































      Page 4					      (73 A2 02MT REV1)






      PRS(1)			  (UNIX	5.0)			 PRS(1)



      EXAMPLES
		prs -d"Users and/or user IDs for :F: are:\n:UN:" s.file

	   may produce on the standard output:

		Users and/or user IDs for s.file are:
		xyz
		131
		abc

		prs -d"Newest delta for	pgm :M:: :I: Created :D: By
		:P:" -r	s.file

	   may produce on the standard output:

		Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas

	   As a	special	case:

		prs s.file

	   may produce on the standard output:

		D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000
		MRs:
		bl78-12345
		bl79-54321
		COMMENTS:
		this is	the comment line for s.file initial delta

	   for each delta table	entry of the ``D'' type.  The only
	   keyletter argument allowed to be used with the special case
	   is the -a keyletter.

      FILES
	   /tmp/pr?????

      SEE ALSO
	   admin(1), delta(1), get(1), help(1),	sccsfile(4).
	   Source Code Control System User's Guide in the ROS Utility
	   Guide.

      DIAGNOSTICS
	   Use help(1) for explanations.











      Page 5					      (73 A2 02MT REV1)



