NAME

comb − combine SCCS deltas

SYNOPSIS

/usr/sccs/comb [ −o ] [ −s ] [ −pSID ] [ −clist ] filename ...

DESCRIPTION

Comb generates a shell procedure (see sh(1)) which, when run, will reconstruct the given SCCS files.  If a directory is named, comb behaves as though each file in the directory were specified as a named file, except that non-SCCS files (last component of the path name 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; non-SCCS files and unreadable files are silently ignored.  The generated shell procedure is written on the standard output. 

OPTIONS

Options are 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. 

−clistA list of deltas to be preserved. All other deltas are discarded.  See get(1) for the syntax of a list. 

−oFor each get −e generated, the reconstructed file is accessed at the release of the delta to be created.  In the absence of the −o option, the reconstructed file is 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. 

−sGenerate a shell procedure which, when run, will produce a report giving, for each file: 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, you should use this option to determine exactly how much space is saved by the combining process. 

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

FILES

s.COMB The name of the reconstructed SCCS file. 

comb?????  Temporary. 

SEE ALSO

sccs(1), admin(1), delta(1), get(1), help(1), prs(1), sccsfile(5). 

Programming Utilities for the Sun Workstation.

DIAGNOSTICS

Use help(1) for explanations.

BUGS

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

Sun Release 3.2  —  Last change: 6 March 1984