User Commands                                        sccs-comb(1)


NAME

     sccs-comb, comb - combine SCCS deltas


SYNOPSIS

     /usr/ccs/bin/comb [-os] [-csid-list] [-psid] s.filename...


DESCRIPTION

     comb generates a shell script (see sh(1)) that you  can  use
     to  reconstruct the indicated s.files.  This script is writ-
     ten to the standard output.

     If a directory name is used in place of the s.filename argu-
     ment, the comb 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.

     If no options are specified, comb preserves  only  the  most
     recent  (leaf)  delta in a branch, and the minimal number of
     ancestors needed to preserve the history.


OPTIONS

     The following options are supported:

     -o           For each `get -e' generated, access the  recon-
                  structed file at the release of the delta to be
                  created. Otherwise, the reconstructed  file  is
                  accessed  at  the most recent ancestor. The use
                  of -o may  decrease  the  size  of  the  recon-
                  structed  s.file.   It may also alter the shape
                  of the delta tree of the original file.

     -s           Generate scripts to gather  statistics,  rather
                  than  combining  deltas.  When  run,  the shell
                  scripts report: the file name, size (in blocks)
                  after   combining,   original   size  (also  in
                  blocks), and the percentage size  change,  com-
                  puted by the formula:

                    100 * ( original - combined ) / original

                  This option can be used to calculate the  space
                  that  will  be saved, before actually doing the

SunOS 5.11           Last change: 2016/11/27                    1


User Commands                                        sccs-comb(1)

                  combining.

     -csid-list   Include the  indicated  list  of  deltas.   All
                  other   deltas  are  omitted.   sid-list  is  a
                  comma-separated list of SCCS delta IDs  (SIDs).
                  To specify a range of deltas, use a `-' separa-
                  tor instead of a comma, between two SIDs in the
                  list.

     -pSID        The SID of the oldest delta to be preserved.

     -V           Prints  the  comb  version  number  string  and
                  exists.


ENVIRONMENT VARIABLES

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

     SCCS_NO_HELP
          If set, comb(1) will  not  automatically  call  help(1)
          with the SCCS error code in order to print a more help-
          ful error message. Scripts that  depend  on  the  exact
          error messages of SCCS commands should set the environ-
          ment variable SCCS_NO_HELP and set LC_ALL=C.


EXIT STATUS

     The following exit values are returned:

     0    Successful completion.

     1    An error occurred.


FILES

     s.COMB     reconstructed SCCS file

     comb?????  temporary file

     dump.core  If the  file  dump.core  exists  in  the  current
                directory  and  a  fatal  signal  is  received, a

SunOS 5.11           Last change: 2016/11/27                    2


User Commands                                        sccs-comb(1)

                coredump is initiated via abort(3).


ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsprot                   |
    |_____________________________|_____________________________|


SEE ALSO

     sccs(1),    sccs-admin(1),     sccs-cdc(1),     sccs-cvt(1),
     sccs-delta(1),   sccs-get(1),   sccs-help(1),   sccs-log(1),
     sccs-prs(1),   sccs-prt(1),   sccs-rmdel(1),   sccs-sact(1),
     sccs-sccsdiff(1),   sccs-unget(1),   sccs-val(1),  bdiff(1),
     diff(1),     what(1),     sccschangeset(4),     sccsfile(4),
     attributes(5), environ(5), standards(5).


DIAGNOSTICS

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


BUGS

     comb may rearrange the shape of the tree of deltas.  It  may
     not  save  any space; in fact, it is possible for the recon-
     structed file to actually be larger than the original.


AUTHORS

     The SCCS suite was origininally written by Marc J.  Rochkind
     at  Bell Labs in 1972.  Release 4.0 of SCCS, introducing new
     versions of  the  programs  admin(1),  get(1),  prt(1),  and
     delta(1)  was  published on February 18, 1977; it introduced
     the new text based SCCS v4  history  file  format  (previous
     SCCS  releases used a binary history file format).  The SCCS
     suite was later maintained by various people at AT&T and Sun
     Microsystems.   Since  2006, the SCCS suite is maintained by
     Joerg Schilling.

SunOS 5.11           Last change: 2016/11/27                    3


Man(1) output converted with man2html


FhG Schily's Home VED powered