comb(1) (Source Code Control System Utilities) comb(1)
NAME
comb - combine SCCS deltas
SYNOPSIS
comb [-o] [-s] [-pSID] [-clist] files
DESCRIPTION
comb generates a shell procedure [see sh(1)] that, when run,
reconstructs the given SCCS files. The reconstructed files are
typically 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
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 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.
The keyletter arguments are as follows. Each argument is explained
as if only one named file is to be processed, but the effects of any
keyletter argument apply 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 This argument causes comb to generate a shell procedure that,
when run, produces a report that gives 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, one should use this option to determine exactly how
much space is saved by the combining process.
-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 of deltas to be preserved. All other deltas are
discarded. See get(1) for the syntax of a list.
8/91 Page 1
comb(1) (Source Code Control System Utilities) comb(1)
If no keyletter arguments are specified, comb preserves only leaf
deltas and the minimal number of ancestors needed to preserve the
tree.
FILES
s.COMB the reconstructed SCCS file
comb????? temporary file
EXAMPLE
comb s.file1 > tmp1
Produces a shell script saved in tmp1 which will remove from the SCCS
format s.file1, all deltas previous to the last set of changes, i.e.,
removes the capability to return to earlier versions.
SEE ALSO
admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4).
sh(1) in the User's Reference Manual.
DIAGNOSTICS
Use help(1) for explanations.
NOTES
comb may rearrange the shape of the tree of deltas.
comb may not save any space; in fact, it is possible for the
reconstructed file to be larger than the original.
Page 2 8/91