IIUG Software Repository Files

README for make_sccs package


Summary:  Example Makefiles and SCCS utilities for I4GL

Environment:  SunOS/Solaris, Informix-4GL, Informix-SQL

Author:  Walt Hultgren, walt@iiug.org


These files are a collections of sample Makefiles and utilities for use with
SCCS for Informix-4GL and Informix-SQL development.

These tools are designed to be used in an environment for the following
characteristics:

  o Informix source file are edited from the command line with vi or some
    other text editor.

  o The "make" command is used to build files rather than the i4gl program
    development environment supplied with IBM Informix.

  o SCCS is used as a source repository.

  o If multiple developers work from the same SCCS repository, each user works
    in their own directory.  The source repository is accessed by placing a
    symbolic link named "SCCS" in each user's working directory that point to
    the central SCCS directory that holds the SCCS delta files.

  o The alternate method of setting the environment variable $PROJECTDIR to
    the pathname of the central SCCS directory is not supported.

  o All SCCS delta files that begin with "s." reside in the repository
    directory.  Thus, command line arguments that start with "s." will be
    passed to the scripts as-is without being expanded even if they contain
    wildcard characters (e. g., "sls s.*.4gl").  The scripts recognize this
    construct as an indication that the SCCS directory should be searched
    for matching files.

  o If a development directory contains subdirectories, the Makefile in that
    directory does not necessarily have to be constructed so that a make in
    that directory causes a make in all lower emanating subdirectories.  The
    "visit" command provides that functionality for those occasions when a
    cascading make is needed.


The following sample Makefiles are included:

Makefile.I4GL   general Makefile for I4GL meant to be included in others
Makefile.ISQL   general Makefile for ISQL meant to be included in others
mf_sample1      sample Makefile showing 4GL development
mf_sample2      sample Makefile showing conditional operations


The following utilities and scripts are included:

make4gl         version of make allowing 4GL-related source file names
qmake           run make "quietly" (in background)
qmake4gl        run make4gl "quietly" (in background)
remake          force make of specified files
remake4gl       force make4gl of specified files
makehere        detect presence of [Mm]akefile
trymake         do a make if [Mm]akefile is present
obj4gl          list 4GL-related object files names of specified source files

sclean          sccs clean - remove safely checked in files
scleanbk        sccs clean, remove .BK files if originals checked into SCCS
screate         sccs create - check a newly created files into SCCS
sdelget         sccs delget - check in delta and check read-only copy back out
sdelta          sccs delta - check in delta of files
sdifflast       sccs sccsdiff on most recent delta
sdiffs          sccs diffs - diff files against SCCS copies
sedit           sccs edit - check out files for editing
sget            sccs get - check out files read-only
sgetall         sccs get - check out all deltas of files
sgetprev        sccs get - check out files read-only as before last delta
sidchk          check files for SCCS ID
sidprt          generate standard SCCS ID
sinfo           sccs info - report files currently checked out for editing
sls             do an ls on SCCS directory
sprt            sccs prt - print delta history
sprtlast        print delta info for most recent delta
stell           list names only of files currently checked out for editing
sunedit         sccs unedit - release edit check-out without changing SCCS file

clean4gl        clean up 4GL temporary files
save            save a timestamped version of a file
showdbe         show database-related environment variables
visit           recursively visit sub-directories and execute a command


All information and files are provided as-is.