This is build_info version 1


    build_info --help



This help text.



    build_info [--build] [build-info-data-file build-info-header-file]



build_info creates a C header file which provides information about the build

environment for a program which can be used to display version information to

a user of the program.



The script creates build_info.h (by default) which defines the following

constants (macros):



BUILD_TITLE - The program title.  This can be any text string but is usually

either a short name (e.g. build_info) or a one-line description (e.g. 

"Create build information header file"). (*)



BUILD_AUTHOR - The program author.  This can be any text string but is usually

either the original author or the most recent modifier. (*)



BUILD_VER - The program version.  This is a text string of the form

<major-version>.<minor-version> (e.g. "10.3"). (*)



BUILD_VER_MAJOR - Major version number.  This is a numeric form of the major

version (e.g. 10). (*)



BUILD_VER_MINOR - Minor version number.  This is a numeric form of the minor

version (e.g. 3). (*)



BUILD_SEQ_NUM - The sequential build number.  This is a number which is

incremented by one each time the script is run. (*)



BUILD_SEQ_ID - Text form of the sequential build number.  This is BUILD_SEQ_NUM

as a string (e.g. "305"). (*)



BUILD_FULL_VER - Major, minor and build number: <major-version>.

<minor-version>-<build-number> (e.g. "10.3-305"). (*)



BUILD_BUILDER - Builder username.  This is the username of the user running

the script (e.g. "cobb").



BUILD_HOST - Builder hostname.  This is the hostname of the system running

the script.



BUILD_DATE - Build date.



BUILD_TIME - Build time



BUILD_YEAR - Year from build date (as a text string)



* - These items are derived from information stored in the build information

data file (build_info.dat by default).



    build_info --create build-info-data-file title author [major-version minor-version build-sequence]



The data file can be created using the --create option.  This requires the

data file name (usually build_info.dat), the title and the author.  The version

numbers and initial build sequence number can also be specified as required

(default is 1.0-0).

