Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

prs


NAME
     sccs-prs, prs - display selected portions of an SCCS history

SYNOPSIS
     /usr/ccs/bin/prs [-ael] [-cdate-time]  [-ddataspec]  [-rsid]
     s.filename...

DESCRIPTION
     The prs utility displays part or all of the SCCS  file  (see
     sccsfile(4)) in a user supplied format.

     If a directory name is used in place of the s.filename argu-
     ment,  the prs command applies to all s.files in that direc-
     tory. Unreadable s.files produce an error;  processing  con-
     tinues  with  the  next file (if any). The use of `-' as the
     s.filename argument indicates that the names of files are to
     be read from the standard input, one s.file per line.

OPTIONS
     In the absence of options,  prs  displays  the  delta  table
     (version log). In the absence of -d, or -l, prs displays the
     entry for each delta indicated by the other options.

     -a              Includes all deltas, including those  marked
                     as removed (see sccs-rmdel(1)).



     -e              Requests information for all deltas  created
                     earlier than, and including, the delta indi-
                     cated with -r or -c.



     -l              Requests information for all deltas  created
                     later  than,  and including, the delta indi-
                     cated with -r or -c.



     -cdate-time     Either options -e or -l must  be  used  with
                     this  option.  -cdate-time displays informa-
                     tion on the deltas checked in  either  prior
                     to and including the date and time indicated
                     by the date-time argument  (option  -e);  or
                     later  than  and including the date and time
                     indicated (option -l). date-time  takes  the
                     form:


                     yy[mm[dd[hh[mm[ss]]]]]

                     Units omitted from the  indicated  date  and
                     time   default  to  their  maximum  possible
                     values; that  is  -c7502  is  equivalent  to
                     -c750228235959.  Any  number  of non-numeric
                     characters may separate the various 2  digit
                     components.    If   white-space   characters
                     occur, the date-time specification  must  be
                     quoted.  Values  of  yy  in  the range 69-99
                     refer to the twentieth  century.  Values  in
                     the range of 00-68 refer to the twenty-first
                     century.



     -ddataspec      Produce a report according to the  indicated
                     data  specification.  dataspec consists of a
                     (quoted) text string that includes  embedded
                     data keywords of the form: `:key:' (see Data
                     Keywords, below). prs expands these keywords
                     in  the output it produces. To specify a TAB
                     character in the output, use \t; to  specify
                     a NEWLINE in the output, use \n.



     -rsid           Specifies the SCCS delta  ID  (SID)  of  the
                     delta  for  which information is desired. If
                     no  SID  is  specified,  the  most  recently
                     created delta is used.



USAGE
     Usage of prs is described below.

  Data Keywords
     Data keywords specify which parts of an SCCS file are to  be
     retrieved.  All parts of an SCCS file (see sccsfile(4)) have
     an associated data keyword. A data keyword  may  appear  any
     number  of  times  in  a  data specification argument to -d.
     These data keywords are listed in the table below:

     Keyword             Data Item             File Section*               Value                Format**
     :A:       a format for the what string:        N/A        :Z::Y: :M: :I::Z:                   S
     :B:       branch number                         D         nnnn                                S
     :BD:      body                                  B         text                                M
     :BF:      branch flag                           F         yes or no                           S
     :CB:      ceiling boundary                      F         :R:                                 S
     :C:       comments for delta                    D         text                                M
     :D:       date delta created                    D         :Dy:/:Dm:/:Dd:                      S
     :Dd:      day delta created                     D         nn                                  S

     :Dg:      deltas ignored (seq #)                D         :DS: :DS:...                        S
     :DI:      seq-no. of  deltas  included,         D         :Dn:/:Dx:/:Dg:                      S
               excluded, ignored
     :DL:      delta line statistics                 D         :Li:/:Ld:/:Lu:                      S
     :Dm:      month delta created                   D         nn                                  S
     :Dn:      deltas included (seq #)               D         :DS: :DS:...                        S
     :DP:      predecessor delta seq-no.             D         nnnn                                S
     :Ds:      default SID                           F         :I:                                 S
     :DS:      delta sequence number                 D         nnnn                                S
     :Dt:      delta information                    D          :DT: :I: :D: :T: :P: :DS: :DP:      S
     :DT:      delta type                            D         D or R                              S
     :Dx:      deltas excluded (seq #)               D         :DS: ...                            S
     :Dy:      year delta created                    D         nn                                  S
     :F:       s.file name                          N/A        text                                S
     :FB:      floor boundary                        F         :R:                                 S
     :FD:      file descriptive text                 C         text                                M
     :FL:      flag list                             F         text                                M
     :GB:      gotten body                           B         text                                M
     :I:       SCCS delta ID (SID)                   D         :R:.:L:.:B:.:S:                     S
     :J:       joint edit flag                       F         yes or no                           S
     :KF:      keyword error/warning flag            F         yes or no                           S
     :L:       level number                          D         nnnn                                S
     :Ld:      lines deleted by delta                D         nnnnn                               S
     :Li:      lines inserted by delta               D         nnnnn                               S
     :LK:      locked releases                       F         :R:...                              S
     :Lu:      lines unchanged by delta              D         nnnnn                               S
     :M:       module name                           F         text                                S
     :MF:      MR validation flag                    F         yes or no                           S
     :MP:      MR validation program                 F         text                                S
     :MR:      MR numbers for delta                  D         text                                M
     :ND:      null delta flag                       F         yes or no                           S
     :Q:       user defined keyword                  F         text                                S
     :P:       user who created delta                D         username                            S
     :PN:      s.file's pathname                    N/A        text                                S
     :R:       release number                        D         nnnn                                S
     :S:       sequence number                       D         nnnn                                S
     :T:       time delta created                    D         :Th:::Tm:::Ts:                      S
     :Th:      hour delta created                    D         nn                                  S
     :Tm:      minutes delta created                 D         nn                                  S
     :Ts:      seconds delta created                 D         nn                                  S
     :UN:      user names                            U         text                                M
     :W:       a form of what string                N/A        :Z::M:\t:I:                         S
     :Y:       module type flag                      F         text                                S
     :Z:       what string delimiter                N/A        @(#)                                S


            *B = body, D = delta table, F = flags, U = user names


     **S = simple format, M = multi-line format


EXAMPLES
     Example 1: Displaying delta entries

     The following command:

     example% /usr/ccs/bin/prs -e -d":I:\t:P:" program.c

     produces:

     1.6    username
     1.5 username...

ENVIRONMENT VARIABLES
     See environ(5) for descriptions of the following environment
     variables  that  affect  the execution of prs: LANG, LC_ALL,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.

FILES
     /tmp/pr?????            temporary file



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsprot                   |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO
     sccs(1),  sccs-cdc(1),  sccs-delta(1),  sccs-get(1),   sccs-
     help(1),    sccs-prt(1),   sccs-sact(1),   sccs-sccsdiff(1),
     what(1),  sccsfile(4),  attributes(5),   environ(5),   stan-
     dards(5)

DIAGNOSTICS
     Use the  SCCS  help  command  for  explanations  (see  sccs-
     help(1)).









Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments