COMB(1) (Source Code Control System Utilities) COMB(1)
NAME
comb - combine SCCS deltas
SYNOPSIS
comb files
DESCRIPTION
comb generates a shell procedure [see sh(1)] which, when
run, will reconstruct the given SCCS files. The
reconstructed files will, hopefully, be 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 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.
-p SID The SCCS ID entification string (SID) of the oldest
delta to be preserved. All older deltas are
discarded in the reconstructed file.
-c list A list of deltas to be preserved. (See get(1) for
the syntax of a list.) All other deltas are
discarded.
-o For each get -e generated, this argument causes the
Page 1 May 1989
COMB(1) (Source Code Control System Utilities) COMB(1)
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 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, 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.
EXAMPLE
comb s.file1 > tmp1
produces a shell script saved in tmp1 which will remove from
the SCCS-format file s.file1 all deltas previous to the last
set of changes, i.e., removes the capability of returning to
earlier versions.
FILES
s.COMB The name of the reconstructed SCCS file.
comb????? Temporary.
SEE ALSO
admin(1), delta(1), get(1), prs(1), sccsfile(4).
help(1), sh(1) in the User's Reference Manual.
DIAGNOSTICS
Use help(1) for explanations.
Page 2 May 1989
COMB(1) (Source Code Control System Utilities) COMB(1)
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.
Page 3 May 1989