comb(1)								       comb(1)

Name
       comb - combine delta versions of SCCS file

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

Description
       The  command  generates	a shell procedure which, when run, will recon‐
       struct the given SCCS files.  For further information, see  The	recon‐
       structed	 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, 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 inde‐
       pendently to each named file.

Options
       -clist	 Preserves specified deltas.  See for the syntax  of  a	 list.
		 All other deltas are discarded.

       -o	 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.

       -pSID	 Indicates oldest delta to be preserved.  All older deltas are
		 discarded in the reconstructed file.

       -s	 Generates  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 com‐
		 puted 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, will preserve only leaf deltas
       and the minimal number of ancestors needed to preserve the tree.

Restrictions
       The  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 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

								       comb(1)

Vote for polarhome