comb

PURPOSE

     Combines SCCS deltas.

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


DESCRIPTION

     The comb command writes to standard output a shell proce-
     dure that can combine the  specified deltas (SIDs) or all
     deltas into one  delta.  You may reduce the  size of your
     SCCS file by running the resulting procedure on the file.
     You can see how much the  file will be reduced by running
     comb with  the -s  flag.  If you  specify a  directory in
     place of file, comb performs the requested actions on all
     SCCS files  (that is, those  with file names with  the s.
     prefix).  If  you specify a  - (minus) in place  of file,
     comb reads standard input and interprets each line as the
     name of an SCCS file.  comb continues to take input until
     it reads END OF FILE (Ctrl-D).

     If you do not specify any flags, comb preserves only leaf
     deltas and the minimal number of ancestors needed to pre-
     serve the tree (see "delta").

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

FLAGS

     Each flag or group of flags applies independently to each
     named file.

     -clist Specifies a  list of deltas (SIDs)  that the shell
            procedure will  preserve (see get -i  list for the
            SID list format).  The  procedure will combine all
            other deltas.
     -o     Accesses the reconstructed file  at the release of
            the delta to be created for each get -e generated;
            otherwise accesses  the reconstructed file  at the
            most  recent  ancestor.   Using the  -o  flag  may
            decrease the size of  the reconstructed SCCS file.
            It may also  alter the shape of the  delta tree of
            the original file.
     -pSID  Specifies  the SID  of  the oldest  delta for  the
            resulting procedure to preserve.  All older deltas
            are combined in the reconstructed file.

     -s     Causes  comb to  generate a  shell procedure  that
            produces a report for  each file giving:  the file
            name, size  (in blocks) after  combining, original
            size (also in blocks),  and percentage change com-
            puted by the formula:

            100 * (original - combined) / original

            You should  run comb using  this flag and  run its
            procedure before combining SCCS  files in order to
            judge how much space will actually be saved by the
            combining process.

FILES

     s.COMB    The name of the reconstructed SCCS file.
     comb*     Temporary files.

RELATED INFORMATION

     The  following  commands:    "admin,"   "delta,"  "get,"
     "help," and  "prs."

     The sccsfile file in  AIX Operating System Technical Ref-
     erence.

     The discussion  of SCCS in AIX  Operating System Program-
     ming Tools and Interfaces.