COMB(CP)                 XENIX System V                  COMB(CP)



     Name
          comb - Combines SCCS deltas.

     Syntax
          comb [-o] [-s] [-psid] [-clist] files

     Description
          comb provides the means to combine one or more deltas in an
          SCCS file and make a single new delta. The new delta
          replaces the previous deltas, making the SCCS file smaller
          than the original.

          comb does not perform the combination itself.  Instead, it
          generates a shell procedure that you must save and execute
          to reconstruct the given SCCS files.  comb copies the
          generated shell procedure to the standard output.  To save
          the procedure, you must redirect the output to a file.  The
          saved file can then be executed like any other shell
          procedure (see sh(C)).

          When invoking comb, arguments may be specified in any order.
          All 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, except that nonSCCS files
          (last component of the pathname does not begin with s.) and
          unreadable files are silently ignored.  If a name of - is
          given, the standard input is read; each line of the standard
          input is taken to be the name of an SCCS file to be
          processed; nonSCCS files and unreadable files are silently
          ignored.

          The options are as follows.  Each is explained as though
          only one named file is to be processed, but the effects of
          any option apply independently to each named file.

          -pSID   The SCCS IDentification string (SID) of the oldest
                  delta to be preserved.  All older deltas are
                  discarded in the reconstructed file.

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

          -o      For each get -e generated, 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 option may decrease the size of the
                  reconstructed SCCS file.  It may also alter the
                  shape of the delta tree of the original file.





     Page 1                                           (printed 8/7/87)

     COMB(CP)                 XENIX System V                  COMB(CP)



          -s      This argument causes comb to generate a shell
                  procedure that will produce a report for each file
                  giving the filename, size (in blocks) after
                  combining, original size (also in blocks), and
                  percentage change computed by:

                       100 * (original - combined) / original

          Before any SCCS files are actually combined, you should use
          this option to determine exactly how much space is saved by
          the combining process.

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

     Files
          comb?????     Temporary files

     See Also
          admin(CP), delta(CP), get(CP), help(CP), prs(CP),
          sccsfile(F)

     Diagnostics
          Use help(CP) for explanations.

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

























     Page 2                                           (printed 8/7/87)