unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

SCCS-PRS(1)                 General Commands Manual                SCCS-PRS(1)



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

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

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

       If a directory name is used in place of the  s.filename  argument,  the
       prs  command  applies  to  all  s.files  in that directory.  Unreadable
       s.files produce an error; processing continues 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     Include all deltas, including those marked as removed (see sccs-
              rmdel(1)).

       -e     Request information for all deltas  created  earlier  than,  and
              including, the delta indicated with -r or -c.

       -l     Request  information  for  all  deltas  created  later than, and
              including, the delta indicated with -r or -c.

       -cdate-time
              Display information on the latest delta checked in prior to  the
              date  and  time  indicated by the date-time argument.  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  com-
       ponents.   If white-space characters occur, the date-time specification
       must be quoted.

       -ddataspec
              Produce a report according to the indicated data  specification.
              dataspec consists of a (quoted) text string that includes embed-
              ded 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  Specify  the SCCS delta ID (SID) of the delta for which informa-
              tion is desired.  If no SID is specified, the most recently cre-
              ated delta is used.

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

       Key-         Data Item           File       Value          Format**
       word                             Sect.*
       :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
       The command:

              /usr/sccs/prs -e -d":I:\t:P:" program.c

       produces:
              1.6  username
              1.5  username
              ...

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

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(5)

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



                                 29 June 1988                      SCCS-PRS(1)