Current Supported Releases: Sablime^® v6.0 & v5.2

NAME
     sidtree - print the SID dependencies in an SBCS or SCCS file

SYNOPSIS
     sidtree [-abu] [-f fields] [-r sid] [-w  width]  [-h  hilit]
     s-file

DESCRIPTION
     sidtree prints a version tree of  an  SBCS  or  SCCS  s-file
     directly to standard output.

     This type of display is useful when the s-file has branches.
     nprs(1)  with  the  options {-e -d:Dt:} prints concise delta
     header information in (reverse) delta  sequence  order,  but
     the  branch  structure  is  not immediately apparent and the
     information can be hard to sort out.

     sidtree is an enhanced nprs -e -d:Dt: that expands  the  SID
     field  into  a  picture  of  the  SID  tree,  with trunk and
     branches clearly outlined.  Because it  does  this  in  real
     time, it can be an effective browsing tool.

OPTIONS
     -a   Include all deltas, even removed ones (nrmdel), in  the
          display.

     -b   Highlight all base versions (see -h option below).

     -u   Print the picture with time going up instead of down.

     -f fields
          fields is a string made from the digits 1 to  9.   Each
          digit  represents  one  more  field of the output.  The
          fields are

               1 delta flag
               2 SID
               3 date of delta
               4 time of delta
               5 author (programmer)
               6 delta sequence number
               7 predecessor delta sequence number  (0  for  base
          versions)
               8 version name (in brackets)
               9 delta character statistics

          Field 2 is always implied by default.

     -h hilit
          Highlight is limited to overstrike and underscore.  The
          user's  pager may map these to color or other highlight
          modes.  The default highlight used is  3  (overstrike),

SBCS Release 1.2    Last change: 1 April 1994                   1

          but  it can be set to 2 (underscore) or 1 (none).  When
          standard  output  is  not  a  terminal,  sidtree  turns
          highlight off, unless the -h[23] option is given.

     -r sid
          Specify a particular version by SID  or  version  name.
          That  version  is then highlighted along with the delta
          path to the base version it depends on.

     -w width
          The maximum total width of the picture, in  characters.
          By  default this number is 80.  sidtree can squeeze the
          picture of the branches, up to a point, to  accommodate
          several fields (-f).

EXAMPLE
          1.1 ------------------------------------+-------+     sable
           |                                      |    1.1.1.1  sable
           |                                   1.1.2.1    |     sable
           |                                      |    1.1.1.2  sable
           |                                   1.1.2.2    |     anil
           |                                      |    1.1.1.3  sable
           |                                   1.1.2.3    |     anil
           |                                   1.1.2.4    |     anil
           |                                      |    1.1.1.4  sable
           |                                   1.1.2.5    |     anil
           |                                      |    1.1.1.5  sable
           |                                   1.1.2.6    |     anil
           |                                      |    1.1.1.6  sable
           |                                   1.1.2.7    |     anil
           |                                      |    1.1.1.7  sable
          2.1 --------------------+-------+       |             sable
           |                      |    2.1.1.1    |             sable
           |                   2.1.2.1    |       |             sable
           |                      |    2.1.1.2    |             sable
           |                      |       |    1.1.2.8          ljh
           |                   2.1.2.2    |       |             ljh
           |                      |       |    1.1.2.9          ljh
           |                   2.1.2.3    |       |             ljh
           |                   2.1.2.4    |       |             prasad
           |                              |    1.1.2.10         prasad
          3.1                             |                     gbrill
          4.1                             |                     gbrill
          5.1 ----+-------+               |                     gbrill
                  |    5.1.1.1            |                     gbrill
               5.1.2.1    |               |                     gbrill
               5.1.2.2    |               |                     gbrill
                       5.1.1.2            |                     wina
                                       2.1.1.3                  wina

                  Figure 1: sidtree -f5 s.sample_sb

SBCS Release 1.2    Last change: 1 April 1994                   2

     The same example is used in nedges(1), but the pictures  use
     a  different  layout.   In sidtree(1) the vertical dimension
     preserves the delta sequence order.

ENVIRONMENT
     sidtree looks for PAGER in the shell environment,  then  for
     the  sbcsenv(1)  variable  pager  [=  "cat"] variable.  If a
     pager is defined sidtree will use it with  highlight  modes.
     If  output  is  explicitly  piped through a pager, highlight
     mode is suppressed and the -h option will have to be  speci-
     fied.

DIAGNOSTICS
     Warning and error messages have error codes that can be used
     with nhelp for a more detailed explanation.

SEE ALSO
     nadmin(1), ndelta(1), nedges(1), nget(1), nhelp(1), nprs(1).

SBCS Release 1.2    Last change: 1 April 1994                   3

Return to SBCS Commands manpage index