prs(1)								       prs(1)



NAME
  prs - Displays key information in a Source Code Control System (SCCS) file

SYNOPSIS

  prs [-a] [-ddataspec] [-r [-rSID]] file

  prs [-e| [-l] [-ccutoff] [-ddataspec] file...

  prs[-e| -l] -rSID [-ddataspec] file ...

FLAGS

  Each flag or group of flags applies independently to each named file.

  -a  Writes information for the specified deltas, whether or not they were
      removed (see the rmdel command).	If you do not specify the -a flag,
      prs supplies information only for the specified deltas that were not
      removed.

  -c cutoff
      Specifies a cutoff date and time for the -e and -l flags.	 Specify cut-
      off  in the following form:
	   yy[mm[dd[hh[mm[ss]]]]]

      All omitted items default to their maximum values, so specifying -c9002
      is the same as specifying -c900229235959.	 You can separate the fields
      with any nonnumeric characters.  For example, you can specify:
	   -c90/2/20,9:22:25

      or
	   -c"90/2/20 9:22:25"

      or
	   "-c90/2/20 9:22:25"

  -d dataspec
      Specifies the data items to be displayed. The dataspec string consists
      of optional text and SCCS file data keywords.  You must enclose all
      text and spaces in dataspec in "" (double quotes).

  -e  Requests information for all deltas created earlier than (and includ-
      ing) the delta specified by the -r flag.

  -l  Requests information for all deltas created later than (and including)
      the delta specified by the -r flag.

  -r[SID]
      Specifies the SID of a delta for which prs will retrieve information.
      If no SID is specified, prs retrieves the information for the SID of
      the highest numbered delta.


DESCRIPTION

  If you specify a directory in place of file, prs performs the requested
  actions on all SCCS files (those with a name that has the s. prefix).	 If
  you specify a - (dash) in place of file, The prs command reads standard
  input and interprets each line as the name of an SCCS file.  The prs
  command continues to take input until it reads an End-of-File character.

  Data Keywords

  Data keywords specify the parts of an SCCS file to be retrieved and written
  to standard output.  All parts of an SCCS file have an associated data key-
  word.	 There is no limit to the number of times a data keyword can appear
  in a string.

  The information that prs displays consists of user-supplied text and
  appropriate values (extracted from the SCCS file) substituted for the
  recognized data keywords in the order of appearance in string.  The format
  of a data keyword value is either simple,where the keyword substitution is
  direct, or multiline, where the substitution is followed by a carriage-
  return.  Text is any characters other than recognized data keywords.
  Specify a tab character with \t and a carriage-return or newline character
  with \n.  Remember to quote the \t and \n with an extra \ (slash) to
  prevent the shell from interpreting the single \ and just passing a t or n
  to prs as text.

  The following table lists the keywords associated with information in the
  delta table in the SCCS file (see the sccsfile file reference page for
  information about file structure).

  Delta Table Keywords

  __________________________________________________________________________

  Keyword   Data Represented	       Value			   Format

  __________________________________________________________________________

  :R:	    Release number	       num			   Simple
  :L:	    Level number	       num			   Simple
  :B:	    Branch number	       num			   Simple
  :S:	    Sequence number	       num			   Simple
  :I:	    SCCS ID string (SID)       :R::L::B::S:		   Simple
  :Dy:	    Year delta created	       YY			   Simple
  :Dm:	    Month delta created	       MM			   Simple
  :Dd:	    Day delta created	       DD			   Simple
  :D:	    Date delta created	       YY/MM/DD			   Simple
  :Th:	    Hour delta created	       HH			   Simple
  :Tm:	    Minute delta created       MM			   Simple
  :Ts:	    Second delta created       SS			   Simple
  :T:	    Time delta created	       HH/MM/SS			   Simple
  :DT:	    Delta type~D or R~Simple
  :P:	    User who created the       login name		   Simple
	    delta
  :DS:	    Delta sequence number      num			   Simple
  :DP:	    Previous delta	       num			   Simple
	    sequence number
  :Dt:	    Delta information	       :DT::I::D: :T::P::DS::DP:   Simple
  :Dn:	    Sequence numbers of	       :DS:...			   Simple
	    deltas included
  :Dx:	    Sequence numbers of	       :DS:...			   Simple
	    deltas excluded
  :Dg:	    Sequence numbers of	       :DS:...			   Simple
	    deltas ignored
  :DI:	    Sequence numbers of	       :Dn:/:Dx:/:Dg:		   Simple
	    deltas included
	    excluded, and ignored
  :Li:	    Lines inserted by Delta    num			   Simple
  :Ld:	    Lines deleted by Delta     num			   Simple
  :Lu:	    Lines unchanged by Delta   num			   Simple
  :DL:	    Delta line statistics      :Li:/:Ld:/:Lu:		   Simple
  :MR:	    MR numbers for delta       text			   Multiline
  :C:	    Comments for delta	       text			   Multiline

  __________________________________________________________________________

  The following table lists the keywords associated with the header flags in
  the SCCS file.  For more information on header flags, see the admin com-
  mand.

  Header Flag Keywords

  ________________________________________________________________

  Keyword   Data Represented		     Value	 Format

  ________________________________________________________________

  :Y:	    Module type			     text	 Simple
  :MF:	    MR validation flag set	     yes or no	 Simple
  :MP:	    MR validation program name	     text	 Simple
  :KF:	    Keyword/error warning flag set   yes or no	 Simple
  :KV:	    Keyword validation string	     text	 Simple
  :BF:	    Branch flag set		     yes or no	 Simple
  :J:	    Joint edit flag set		     yes or no	 Simple
  :LK:	    Locked releases		     :R:...	 Simple
  :Q:	    User-defined keyword	     text	 Simple
  :M:	    Module name			     text	 Simple
  :FB:	    Floor boundary		     :R:	 Simple
  :CB:	    Ceiling boundary		     :R:	 Simple
  :Ds:	    Default SID			     :I:	 Simple
  :ND:	    Null delta flag set		     yes or no	 Simple
  :FL:	    Header flag list		     text	 Multiline

  ________________________________________________________________

  The following table lists the keywords associated with other parts of the
  SCCS file.

  Other Keywords

  ________________________________________________________________

  Keyword   Data Represented	    Value		 Format

  ________________________________________________________________

  :UN:	    Usernames		    text		 Multiline
  :FD:	    Descriptive text	    text		 Multiline
  :BD:	    Body of text	    text		 Multiline
  :GB:	    Text in a g-file	    text		 Multiline
  :W:	    what string		    :Z::M:    :I:	 Simple
  :A:	    what string		    :Z::Y::M::I::Z:	 Simple
  :Z:	    what string delimiter   @(#)		 Simple
  :F:	    SCCS filename	    text		 Simple
  :PN:	    SCCS file pathname	    text		 Simple

  ________________________________________________________________




EXAMPLES

   1.  To display information on all deltas generated for SCCS filename
       s.test.c (including all deltas removed using rmdel), enter:
	    prs -a s.test.c


   2.  To display username, the number of lines inserted by delta, and the
       number of lines deleted by delta for SID 1.2 of s.test.c, enter:
	    prs -r1.2 -d":P::Li::Ld:" s.test.c


FILES

  /tmp/pr?????
	     Temporary files.

RELATED INFORMATION

  Commands:  admin(1), cdc(1), comb(1), delta(1), get(1), rmdel(1), sact(1),
  sccsdiff(1), sccshelp(1), unget(1), val(1), what(1).

  Files:  sccsfile(4).