Name

comb − combine delta versions of SCCS file

Syntax

comb [−o] [−s] [−psid] [−clist] files

Description

The comb command generates a shell procedure which, when run, will reconstruct the given SCCS files.  For further information, see sh(.). The reconstructed files are generally smaller than the original files. The arguments may be specified in any order, but all keyletter arguments 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 non-SCCS files (last component of the path name does not begin with s.) and unreadable files, which 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. 

The generated shell procedure is written on the standard output. 

Each keyletter argument is explained as though only one named file is to be processed, but the effects of any keyletter argument apply independently to each named file. 

Options

−clistPreserves specified deltas.  See get() for the syntax of a list.  All other deltas are discarded. 

−oCauses 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. 

−pSIDIndicates oldest delta to be preserved.  All older deltas are discarded in the reconstructed file. 

−sGenerates a shell procedure which produces a report.  This report gives the file name, size (in blocks) after combining, original size (also in blocks), and percentage change computed by:

­100 ∗ (original − combined) / original

It is  recommended that before any SCCS files are actually combined, one should use this option to determine exactly how much space is saved by the combining process. 

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

Restrictions

The comb command 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 actually be larger than the original.

Diagnostics

See sccshelp() for explanations.

Files

s.COMB The name of the reconstructed SCCS file. 

comb?????  Temporary. 

See Also

admin(1), delta(1), get(1), help(1), prs(1), sccs(1), sccsfile(5)
Guide to the Source Code Control System