comb(1)                                                             comb(1)

NAME
     comb - combine SCCS deltas

SYNOPSIS
     comb [-o] [-s] [-pSID] [-clist] file...

DESCRIPTION
     comb (combine) generates a shell procedure with which the specified
     SCCS files can be reconstructed. The reconstructed files are, in gen-
     eral, smaller than the original files. The arguments may be specified
     in any order, but all the options apply to all named SCCS files. If a
     directory is named, comb behaves as though each file in the directory
     were specified as a named file. This does not apply for non-SCCS files
     - i.e. those for which the filename does not begin with s., ignoring
     the pathname - and unreadable files; these files are ignored without
     comment. If a name of - is given, the standard input is read; each
     line of the input is taken to be the name of an SCCS file to be pro-
     cessed. The generated shell procedure is written on the standard out-
     put.

OPTIONS
     The options will be applied independently to each named file.

     -o    For each get -e, this argument causes the reconstructed file to
           be accessed at the release of the delta to be created, otherwise
           the reconstructed file would be accessed at the most recent
           ancestor. Use of the -o keyletter may decrease the size of the
           reconstructed SCCS file. It may also alter the shape of the
           delta tree of the original file.

     -s    comb will generate a shell procedure that, when run, produces a
           report that gives for each file: the filename, its size in
           blocks after applying comb, its original size in blocks, and
           percentage change. The latter is computed as follows:

           100 * (original size - new size) / original size

           This option should be used before any SCCS files are actually
           combined, to determine how much space will be saved.

     -pSID Specifies the SCCS identification string (SID) of the oldest
           delta to be preserved. All older deltas are deleted from the
           reconstructed file.

     -clist
           A list of deltas to be preserved. All other deltas are discarded
           (see get(1) for the syntax of a list).

     If no options are specified, comb preserves only leaf deltas and the
     minimal number of ancestors needed to preserve the tree.





Page 1                       Reliant UNIX 5.44                Printed 11/98

comb(1)                                                             comb(1)

NOTES
     comb may rearrange the shape of the tree of deltas. In some cir-
     cumstances, comb may not save any space; in fact, it is possible for
     the reconstructed file to be larger than the original.

FILES
     s.COMB      the reconstructed SCCS file
     comb?????   temporary file

SEE ALSO
     admin(1), delta(1), get(1), prs(1), sh(1), sccsfile(4).











































Page 2                       Reliant UNIX 5.44                Printed 11/98