unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



prs(1)								       prs(1)



NAME

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

SYNOPSIS

  prs [-a] [-d dataspec] [-r[SID]] file...

  prs [-e  | -l] [-c cutoff] [-d dataspec] file...

  prs [-e  | -l] -r[SID] [-d dataspec] file...

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  prs:	XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

  -a  Writes information for the specified deltas, whether or not they were
      removed (see the rmdel(1)	reference page).  If you do not	specify	the
      -a option, 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 options.  Specify
      cutoff 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"

      [Tru64 UNIX]  For	the yy component, values in the	range [69-99], prs
      interprets it as being in	the twentieth century, i.e. (1969 to 1999
      inclusive); values in the	range [00-68], prs interprets it as being in
      the twenty-first century ie. (2000 to 2068 inclusive).

  -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 option.

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

  -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. If SID is specified, you must	not use	a
      space between the	-r and the SID.

OPERANDS

  file
      The path name of an existing SCCS	file or	directory.

      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	stan-
      dard 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	char-
      acter.

DESCRIPTION

  The prs command reads	SCCS files, and	writes to standard output a part or
  all of the file according to a format	you specify.

  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(4) reference page for infor-
  mation 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:				:R::L::B::S:	    Simple

	    SCCS ID string
	    (SID)
  :Dy:				YY		    Simple

	    Year delta
	    created
  :Dm:				MM		    Simple

	    Month delta
	    created
  :Dd:	    Day	delta created	DD		    Simple
  :D:				YY/MM/DD	    Simple

	    Date delta
	    created
  :Th:				HH		    Simple

	    Hour delta
	    created
  :Tm:				MM		    Simple

	    Minute delta
	    created
  :Ts:				SS		    Simple

	    Second delta
	    created
  :T:				HH/MM/SS	    Simple

	    Time delta
	    created
  :DT:

	    Delta type~D or
	    R~Simple
  :P:				login name	    Simple

	    User who created
	    the	delta
  :DS:				num		    Simple

	    Delta sequence
	    number
  :DP:				num		    Simple

	    Previous delta
	    sequence number
  :Dt:	    Delta information			    Simple

				:DT::I::D:
				:T::P::DS::DP:
  :Dn:				:DS:...		    Simple

	    Sequence numbers
	    of deltas
	    included
  :Dx:				:DS:...		    Simple

	    Sequence numbers
	    of deltas
	    excluded
  :Dg:				:DS:...		    Simple

	    Sequence numbers
	    of deltas ignored
  :DI:				:Dn:/:Dx:/:Dg:	    Simple

	    Sequence numbers
	    of deltas
	    included,
	    excluded, and
	    ignored
  :Li:				num		    Simple

	    Lines inserted by
	    Delta
  :Ld:				num		    Simple

	    Lines deleted by
	    Delta
  :Lu:				num		    Simple

	    Lines unchanged
	    by Delta
  :DL:				:Li:/:Ld:/:Lu:	    Simple

	    Delta line
	    statistics
  :MR:				text		    Multiline

	    MR numbers for
	    delta
  :C:				text		    Multiline

	    Comments for
	    delta
  ___________________________________________________________

  The following	table lists the	keywords associated with the header flags in
  the SCCS file.  For more information on header flags,	see the	admin(1)
  reference page.



  Header Flag Keywords




  ___________________________________________________
  Keyword   Data Represented	Value	    Format
  ___________________________________________________
  :Y:	    Module type		text	    Simple
  :MF:				yes or no   Simple

	    MR validation
	    flag set
  :MP:				text	    Simple

	    MR validation
	    program name
  :KF:				yes or no   Simple

	    Keyword/error
	    warning flag set
  :KV:				text	    Simple

	    Keyword valida-
	    tion string
  :BF:	    Branch flag	set	yes or no   Simple
  :J:				yes or no   Simple

	    Joint edit flag
	    set
  :LK:	    Locked releases	:R:...	    Simple
  :Q:				text	    Simple

	    User-defined key-
	    word
  :M:	    Module name		text	    Simple
  :FB:	    Floor boundary	:R:	    Simple
  :CB:	    Ceiling boundary	:R:	    Simple
  :Ds:	    Default SID		:I:	    Simple
  :ND:				yes or no   Simple

	    Null delta flag
	    set
  :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:						    Simple

	    what string

				:Z::M:	<Tab> :I:
  :A:				:Z::Y::M::I::Z:	    Simple

	    what string
  :Z:				@(#)		    Simple

	    what string	del-
	    imiter
  :F:	    SCCS file name	text		    Simple
  :PN:				text		    Simple

	    SCCS file path
	    name
  ___________________________________________________________

EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion.

  >&gt;0  An error occurred.





EXAMPLES

   1.  To display information on all deltas generated for SCCS file name
       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



ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of prs:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments and input files).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.

FILES

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

SEE ALSO

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

  Files:  sccsfile(4)

  Standards:  standards(5)

  Programming Support Tools