http://invisible-island.net/ded/sccs_tools/


putdelta(man)


NAME

       putdelta - SCCS check-in utility


USAGE

       putdelta [options] [file-specifications]


SYNOPSIS

       Putdelta  is  a simple, easy to use interface to sccs (source code con-
       trol system).  It checks into the sccs archive all files specified.


DESCRIPTION

       Putdelta uses the sccs utilities admin and delta to  maintain  versions
       of a given source file in a dependent directory named "SCCS" It is more
       than an integration of the admin and delta utilities, however:

       o   If the sccs archive directory does not already exist, putdelta cre-
           ates it.

       o   If  the  file has not been locked, putdelta creates a lock (i.e., a
           "p." file).  If a "p." file already exists, putdelta  will  attempt
           to  use the lock However, if the lock belongs to another user, put-
           delta will not check-in the file.

       o   Putdelta retains the executable-mode of the file which is  checked-
           in  That  is, if it is a shell-script (and has a mode such as 755),
           the mode of sccs "s." file is set to 555 The getdelta utility works
           in  the opposite fashion, setting the extracted file's mode to cor-
           respond to that of the "s."  file.

       o   Putdelta sets the "-n" option of delta, so that your  file  is  not
           deleted after check-in.

       o   The  "s."  file  is post-processed by putdelta so that the check-in
           date matches the file's modification date.

       The last point is the fundamental advantage offered by  putdelta.   The
       ordinary  sccs  methodology  uses the current date as the check-in date
       This works well only for large projects  in  which  a  central  project
       administrator  is  responsible  for  controlling the versions of source
       files It does not work well for small projects, for which  sccs's  pri-
       mary advantage is its compact storage of multiple versions of a file.

       By using the file's modification date as a reference, you can more eas-
       ily back up to a meaningful version - by date, rather than version num-
       ber.

       Putdelta  integrates  the essential functions used in the sccs check-in
       process into one utility program.


OPTIONS

       The options which you may specify to putdelta are passed through to the
       underlying admin and delta utilities:

       -s     suppresses  some of the messages generated by the sccs admin and
              delta utilities describing the number of lines changed, etc.

       -ytext specifies the change-history text.  You  will  be  prompted  for
              this  if  you  do not supply it, in versions after the first, by
              the delta utility.


OPERATIONS

       Putdelta is designed to operate with the standard sccs utilities with a
       minimum  of fuss and bother It retains your working file after check-in
       since that facilitates development In effect,  it  simply  appends  the
       current version of each file which you specify onto the archive.


ENVIRONMENT

       Environment variables imported by putdelta include:

       SCCS_DIR
              specifies  the  directory  into  which  the  sccs "s." files are
              stored If no specified, putdelta assumes "SCCS".

       TZ     is the prevailing timezone,  which  putdelta  uses  to  set  the
              check-in  date  in  the  "s." file Putdelta sets the timezone to
              EST5EDT, in part to avoid conflict with get's date checking.


FILES

       Putdelta is a single binary file, written in C It runs in a POSIX envi-
       ronment.


ANTICIPATED CHANGES

       Provide  a  mechanism  for inserting dummy version numbers so that put-
       delta can bump the release number (for  genuine  major  releases)  Cur-
       rently, the SID's are restricted to 1.1, 1.2, 1.3, etc.


SEE ALSO

       sccsput, sccsget, getdelta, admin (1), delta (1)


AUTHOR

       Thomas Dickey (Software Productivity Consortium).

                                                                   PUTDELTA(1)