prs man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

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	 stan‐
       dards as follows:

       prs:  XCU5.0

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

OPTIONS
       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.  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 sepa‐
	      rate 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 inclu‐
	      sive).   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).	Requests information for all  deltas  created  earlier
	      than  (and  including)  the  delta  specified  by the -r option.
	      Requests information for all  deltas  created  later  than  (and
	      including)  the delta specified by the -r option.	 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
       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 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.

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  associ‐
       ated  data  keyword.   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 sub‐
       stitution 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 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   :R::L::B::S:	 Simple
		 (SID)
       :Dy:	 Year  delta  cre‐   YY			 Simple
		 ated
       :Dm:	 Month	delta cre‐   MM			 Simple
		 ated
       :Dd:	 Day delta created   DD			 Simple
       :D:	 Date  delta  cre‐   YY/MM/DD		 Simple
		 ated
       :Th:	 Hour  delta  cre‐   HH			 Simple
		 ated
       :Tm:	 Minute delta cre‐   MM			 Simple
		 ated
       :Ts:	 Second delta cre‐   SS			 Simple
		 ated
       :T:	 Time  delta  cre‐   HH/MM/SS		 Simple
		 ated
       :DT:	 Delta	type~D	or
		 R~Simple
       :P:	 User who  created   login name		 Simple
		 the delta
       :DS:	 Delta	  sequence   num		 Simple
		 number
       :DP:	 Previous    delta   num		 Simple
		 sequence number
       :Dt:	 Delta information   :DT::I::D:		 Simple
				     :T::P::DS::DP:
       :Dn:	 Sequence  numbers   :DS:...		 Simple
		 of	    deltas
		 included

       :Dx:	 Sequence  numbers   :DS:...		 Simple
		 of	    deltas
		 excluded
       :Dg:	 Sequence  numbers   :DS:...		 Simple
		 of deltas ignored
       :DI:	 Sequence  numbers   :Dn:/:Dx:/:Dg:	 Simple
		 of	    deltas
		 included,
		 excluded,     and
		 ignored
       :Li:	 Lines inserted by   num		 Simple
		 Delta
       :Ld:	 Lines deleted	by   num		 Simple
		 Delta
       :Lu:	 Lines	 unchanged   num		 Simple
		 by Delta
       :DL:	 Delta	line  sta‐   :Li:/:Ld:/:Lu:	 Simple
		 tistics
       :MR:	 MR   numbers  for   text		 Multiline
		 delta
       :C:	 Comments      for   text		 Multiline
		 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:	 MR	validation   yes or no	 Simple
		 flag set
       :MP:	 MR	validation   text	 Simple
		 program name
       :KF:	 Keyword/error	     yes or no	 Simple
		 warning flag set
       :KV:	 Keyword   valida‐   text	 Simple
		 tion string
       :BF:	 Branch flag set     yes or no	 Simple
       :J:	 Joint	edit  flag   yes or no	 Simple
		 set
       :LK:	 Locked releases     :R:...	 Simple
       :Q:	 User-defined key‐   text	 Simple
		 word
       :M:	 Module name	     text	 Simple
       :FB:	 Floor boundary	     :R:	 Simple
       :CB:	 Ceiling boundary    :R:	 Simple
       :Ds:	 Default SID	     :I:	 Simple
       :ND:	 Null  delta  flag   yes or no	 Simple
		 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:	 what string	     :Z::M:  <Tab> :I:	 Simple
       :A:	 what string	     :Z::Y::M::I::Z:	 Simple

       :Z:	 what	    string   @(#)		 Simple
		 delimiter
       :F:	 SCCS file name	     text		 Simple
       :PN:	 SCCS  file   path   text		 Simple
		 name
       ────────────────────────────────────────────────────────────

EXIT STATUS
       The  following  exit  values  are  returned: Successful completion.  An
       error occurred.

EXAMPLES
       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 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:  Pro‐
       vides  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 vari‐
       ables contain an invalid setting, the utility behaves as if none of the
       variables  had been defined.  If set to a non-empty string value, over‐
       rides the values	 of  all  the  other  internationalization  variables.
       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).	 Determines the locale
       for the format and contents of diagnostic messages written to  standard
       error.	Determines the location of message catalogues for the process‐
       ing of LC_MESSAGES.

FILES
       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

									prs(1)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net