
           CHIEF'S GENERIC INSTALL for WINDOWS v2.70
           -----------------------------------------

           (c) 1994, Dr. Abimbola A. Olowofoyeku (The African Chief)
           ----------------------------------------------------------


    Files in the package
    --------------------
    1. INSTALL.EXE    (Windows install executable)
    2. WINSTALL.HLP   (basic help file for the installer)
    3. SETUP.EXE      (OPTIONAL small loader for INSTALL.EXE)
    4. xxx.DLL        (OPTIONAL LANGUAGE DLLs for the string messages)
                      (you can rename the one you need to WINSTALL.DLL)
    5. WINSTALL.RC    (Resource script for WINSTALL.DLL)
    6. SAMPLExx.INF   (sample INF files for WINSTALL.INF)
    7. INSTALL.TXT    (this file)


    What is CHIEF'S GENERIC INSTALL?
    --------------------------------
    Chief's Generic Install (hereinafter referred to as "Install") is a
    generic program for installation of Windows applications.

    Install is an "off-the-shelf" installation suite. The program will
    copy files from floppy disks (or a directory on a hard disk) to the
    destination directory. If the files are compressed with Microsoft's
    COMPRESS.EXE they will be decompressed automatically.In this respect
    Install uses the routines in LZEXPAND.DLL. If the files are not
    compressed, they will simply be copied.

    -----
    NOTE:
    -----
    The main executable is INSTALL.EXE - and that is all that needs to
    be run. I have supplied SETUP.EXE as an optional loader. All it does
    is to;

     [a] display a "initializing install ..." message
     [b] copy the necessary Install files (INSTALL.EXE, WINSTALL.INF,
         WINSTALL.HLP, and WINSTALL.DLL (if it exists)) to the TEMP
         directory.

         For these purposes, these 4 files may be compressed on the
         install disks - but they must retain their real names (as
         above) - except INSTALL.EXE, which if compressed with the -r
         option, can be called "INSTALL.EX_" (the original name will
         be restored by SETUP.EXE)
     [c] load the copy of INSTALL.EXE from the TEMP directory, with the
         parameters necessary for it to work properly if run in this
         way


    Is this useful? "It depends" is the answer. If there is more than
    one installation diskette, then it WILL help a lot, and save you
    the embarrassment of Windows trying to read from INSTALL.EXE after
    disk 4 (or whatever), and the disk in the floppy drive does not contain
    INSTALL.EXE. If there is only one installation diskette, it may help
    keep the user occupied while INSTALL.EXE is loading.

    SETUP.EXE is here mainly for future purposes (especially, as
    INSTALL.EXE seems to be getting bigger all the time), and for people
    who prefer to type "A:SETUP" instead of "A:INSTALL".


    INTERNATIONAL and FOREIGN LANGUAGE SUPPORT
    ------------------------------------------
    All the string messages presented to the user by Install are
    in string tables. There is an internal ENGLISH string table in
    INSTALL.EXE, and these will normally be used to display all the
    messages and information.

    However, Install will always look for a dynamic link library file
    called WINSTALL.DLL from which to load the string tables. If this
    file is found, the string tables are read from it by Install at
    startup time. If you are going to use this DLL, it MUST be in the
    same directory as INSTALL.EXE. If WINSTALL.DLL is not found, Install
    will use the default (English) string tables inside INSTALL.EXE
    itself.


    What this means is that you can change the language used by Install
    by simply producing your own translations of the English string tables,
    and compiling them into a .DLL file called WINSTALL.DLL. For these
    purposes, I have provided copy of my WINSTALL.RC file - the resource
    script used to create the English string tables. You can easily
    translate this script and then compile your own WINSTALL.DLL.

    *** If anyobdy produces a non-English translation of this script file,
    please send me a copy, so that I can package non-English versions of
    the DLL with Install. I would ask people to please help in this regard,
    so that others can benefit from this feature.


    NOTES:
    ------
     [a] NO checking is carried out to verify the contents of these
         string tables, or even their existence. Thus, if you edit the
         string tables and/or produce your own WINSTALL.DLL file,
         you are *totally* on your own.

    [b] I can only vouch for the accuracy of the English version of the
        DLL - and even then,  only the version which was produced by me.
        If I package any non-English version of the DLL, please don't stone
        me if the translation is incorrect - but if you do find errors,
        please DO send me what you think is a correct translation of the
        resource script.

    [c] The messages in and many other parameters used by SETUP.EXE are also
        contained in string tables, but these are only loaded from SETUP.EXE
        itself. If you want to translate the messages to another language,
        you will need a resource editor to do so. In this respect, note that
        ONLY the strings with the IDs 1 to 4 can be changed. The other
        strings are for internal use by SETUP.EXE, and should NOT be
        changed. If you change them, you do so at your own risk, and I will
        answer NO QUESTIONS in respect of these strings.



    ---------------------
    ---------------------
    Using Chief's Install
    ---------------------
    ---------------------
    I have tried to make Install as easy to use as possible. You only
    need to take the following steps;

      1. Create your installation disk set by placing your application's
         files on them (up to 45 installation disks are supported).

     2.  You may or may not compress the files with COMPRESS.EXE (it is
         immaterial whether you do so or not). If files are compressed
         and an underscore is used in the compressed file names, these
         names will only be converted to the original file names if
         they were compressed with the -r option.


      3. Create an installation information file in ASCII format, using a
         text editor. The file should be called WINSTALL.INF, and should be
         in the format described below.

      4. Run the Install program.

    That's it folks!


    Restrictions/Features
    ---------------------
    1. You can only install into any combination of the following;
         (a) ONE destination directory, and up to 45 subdirectories
             under it
         (b) the Windows directory
         (c) the Windows SYSTEM directory
         (d) the TEMP directory
    2. Only a maximum of 45 installation disks are supported. Install will
       prompt for the disks as they are required.
    3. Install will optionally offer to put the destination directory
       into the "PATH" statement in AUTOEXEC.BAT
    4. Install will optionally create a Program Manager group file, and
       icons for any supplied file(s) - .EXEs, README files, etc.
    5. Install will optionally run any supplied program(s) during the
       installation, as part of the installation process.
    6. Install will optionally run any supplied program(s) immediately after
       the installation is complete
    7. The stipulated format of the WINSTALL.INF file must be followed
       strictly.
    8. Install allows you to supply on-line for the installation.
       You have to create a Windows help file called WINSTALL.HLP. This
       help file can be accessed by clicking on the "HELP" button. A simple
       one is supplied. You can either use that, or create your own.
       If no WINSTALL.HLP file is found in the path, then the "HELP"
       button is removed from the Install window.
    9. Install will check whether there is sufficient space on the target
       drive - based on information which you supply as to how much disk
       space your application requires.
       If you need extra temporary disk space for the installation, Install
       can check for this also.
   10. Install will make entries in any INI (or other) file(s) specified
       by you. Up to 20 entries can be made. Do NOT use this feature to
       insert an entry which may already exist - the old entry will be
       deleted and replaced by the new one (e.g., do NOT use it for
       "DEVICE=" lines in SYSTEM.INI
   11. Install provides support for non-English languages - it will look
       for a DLL called WINSTALL.DLL in the directory from which INSTALL.EXE
       is executed. If this DLL is found, Install will load the string tables
       used for messages from it.


    The format of WINSTALL.INF
    --------------------------
    WINSTALL.INF is the configuration file for the installation. You need
    to follow the instructions on this file carefully, otherwise, Install
    will not work correctly. The best thing is to edit the sample files
    which I have provided. They contain sufficient comments for you to
    understand them. WINSTALL.INF is a standard ASCII file, in the
    following format;

    1. Any line beginning with a ";", or "[" or "REM" is ignored
    2. Empty lines are ignored

          e.g., these lines will be ignored

              [This line will be ignored]
              ; So will this line

              REM  so will the one just above me, and me as well!


    3. Each line must not contain more than 220 characters

    4. There are RESERVED WORDS for each valid entry - as follows;
                 --------------

          $TITLE      : your program's title
          $TARGET     : the default target directory
          $SPACE      : the amount disk space needed for the install
          $SWAP-SPACE : any temporary swap space needed for the install
          $DISK       : 1-45 = the installation disks and their contents
          $DEST       : points to the target directory chosen by the user
          $WINDIR     : points to the Windows directory
          $SYSDIR     : points to the Windows SYSTEM directory
          $TEMPDIR    : points to the TEMP directory
          $INI        : text file(s) to write entries into
          $GROUP      : title of the Program Manager group
          $ICON       : file(s) to create Program Manager icons for
          $PRE-EXEC   : program(s) to run DURING the installation
          $EXEC       : program(s) to run AFTER the installation
          $CLEANUP    : file(s) to be deleted AFTER the installation
          $WINDOW     : whether INSTALL should start MAXIMIZEd or not

          $NO-END-DIALOG     : to disable the final "installation completed"
                               dialog.
          $NO-PATH-DIALOG    : to disable dialog to update AUTOEXEC.BAT
          $AUTO-REPLACE      : to replace older existing files automatically
          $WINDOW-BACKGROUND : to change the background color of the window
          $TEXT-BACKGROUND   : to change the background color of the text
          $PAINTDIALOGS      : to paint the backgrounds of the status dialogs
          $COPYBUFFER        : the size of the buffer used for copying the
                               files
          $SETCHECKBOX       : to automatically set the checkbox for creation
                               of Program Manager group


    RESERVED WORD
    *************

    $DISK
    -----
    You use this reserved word to specify the disk(s) in the installation
    set, and the file(s) which should be copied from them. Each file name
    or file specification should be separated from the next one by a
    semi-colon.

    You can use the wildcard character "*" in this regard. The format for
    specifying the disk(s) is this;

         $DISK n = <filenames(s)>

            where:
             n = numbers from 1 to 45
             <filename(s)> = the file specifications
             the easiest thing to do would be to just specify "*.*" - to
             copy all the files - but you can be more specific

        EXAMPLES:
          $DISK 1 = *.*
          $DISK 2 = *.DLL;*.HLP;*.DRV;WS*.*;EXPAND.*;COMPRESS.EXE;README.TXT
          $DISK 3 = HELP.DOC;*.FFF


       * If you specify a file that does not exist on the disk, it will just
         be ignored.

       * A maximum of 30 file specifications is allowed on each "$disk" line -
         but note that each line cannot be longer than 220 characters in total.

       * Compressed files with underscores in the filename will have the
         filenames expanded into the name of the original files ONLY if
         the original files were compressed with the -r option


    RESERVED WORD
    *************

    $TITLE
    ------
    This us used to specify the name or title of your application. This is
    what will appear in the title of the installation program's window -
    You can have only ONE such line.
    - e.g.;
            $TITLE=Great Program v1.20


    RESERVED WORD
    *************

    $SPACE
    ------
    Use this to specify the amount of disk space needed for the installation.
    The amount should be in BYTES and should only contain whole numbers (no
    spaces, no letters, and no decimals).

    This information is used by Install to warn the users of the amount
    of space that they need to have free on their disks, and to show the
    progress of the installation in the "percentage meter". Install will
    check to see that the specified amount of space exists on the
    target drive before installation begins. If there is insufficient
    space, Install will abort with an error message.

    There is no need for the number to correspond exactly with the actual
    required number of bytes - a difference of up to 2% of the size of
    your application (plus or minus) is allowed, and such differences will
    be catered for automatically. In fact, it is always good to add about
    1% to the actual disk space needed - because of the vagaries of disk
    cluster sizes, it may be wise to over-estimate the disk space needed
    (a little bit of trial and error is in order here).
    You can have only ONE such line.

    e.g.,

         $SPACE=2002003


    $SWAP-SPACE
    -----------
    Use this to specify the amount of any temporary swap disk space
    needed for the installation. The amount should be in BYTES and
    should only contain whole numbers (no spaces, no letters, and
    no decimals).

    This information is used by Install to warn the users of the amount
    of space that they need to have free on their disks - bit it does not
    show in the "percentage meter".

    You can have only ONE such line.

    e.g.,

         $SWAP-SPACE=0


    RESERVED WORD
    *************

    $TARGET
    -------
    This is used to specify the name of the DEFAULT target directory for the
    installation. The user will be able to change this at run time.
     - e.g.,
            $TARGET=C:\MYPROGRAM

     If the target directory does not exist Install will create it - but
     note that it will not create directories recursively.
     You can have only ONE such line.


     Other Directories
     -----------------
     By default, ALL the files will be installed into whatever is the target
     directory chosen by the user. You can however specify that certain files
     should be installed into subdirectories UNDER THE TARGET DIRECTORY TREE,
     or into the WINDOWS DIRECTORY, or into the WINDOWS SYSTEM DIRETORY, or
     into the TEMP DIRECTORY.

     To use this, you use the $DEST, $WINDIR, $SYSDIR, $TEMPDIR reserved words.


    RESERVED WORD
    *************

     $DEST
     -----
     [i] Where ever this appears at the beginning of a line, the following take place;
          (a) "$DEST" is replaced with the target directory selected by the
              user. For example, entry of "$DEST\BIN=PROG.EXE", if the user
              installed to "C:\NEWPROG", becomes "C:\NEWPROG\BIN=PROG.EXE"
          (b) anything after the "=" sign is taken as the file(s) to be installed into
              that directory (instead of into the target directory). There can be up to
              14 file names, each separated by a semi-colon (NO wildcards are allowed
              here!).

     The sub directories will be created when necessary - but note that the order in which
     they are specified may be important - if there are deep levels of nesting, the ones
     higher up the tree must be specified first.

     You can have up to 45 such lines.

     [ii]  Where ever this appears elsewhere in a line, the "$DEST" is replaced with
           the target directory selected by the user. This use of the $DEST reserved
           word is only useful in the "$ICON", "$INI", and "$EXEC" lines.


    RESERVED WORD
    *************

     $WINDIR
     -------
       [i] Whenever this appears at the beginning of a line, the files on that line are
           installed to the Windows directory (instead of the target directory).
           There can be up to 14 file names, each separated by a semi-colon (no wildcards
           are allowed here).
       You can have only ONE such line.

       [ii] Where ever this appears elsewhere in a line, the "$WINDIR" is replaced with
           the Windows directory. This use of the $WINDIR reserved word is only useful in
           the "$ICON", "$INI", and "$EXEC" lines.


    RESERVED WORD
    *************

     $SYSDIR
     -------
       [i] Whenever this appears at the beginning of a line, the files on that line are
           installed to the Windows SYSTEM directory (instead of the target directory).
           There can be up to 14 file names, each separated by a semi-colon (no wildcards
           are allowed here).
       You can have only ONE such line.

       [ii] Where ever this appears elsewhere in a line, the "$SYSDIR" is replaced with
           the Windows SYSTEM directory. This use of the $SYSDIR reserved word is only
           useful in the "$ICON", and "$EXEC" lines.


    RESERVED WORD
    *************

     $TEMPDIR
     --------
       [i] Whenever this appears at the beginning of a line, the files on that line are
           installed to the TEMP directory (instead of the target directory).
           There can be up to 14 file names, each separated by a semi-colon (no wildcards
           are allowed here).
       You can have only ONE such line.

       [ii] Where ever this appears elsewhere in a line, the "$TEMPDIR" is replaced with
           the TEMP directory. This use of the $TEMPDIR reserved word is only useful in
           the "$INI", and "$EXEC" lines.



    RESERVED WORD
    *************

     $AUTO-REPLACE
     -------------
     Use this to specify any files that should be replace automatically
     if they already exist (i.e., without first prompting the user for
     confirmation).

     This reserved word if effective for matching files which exist in the
     target directory, and which are NOT newer (by their date stamp) than
     the files being installed. If the existing file has got a more recent
     date stamp than the one being installed, then the user WILL be
     prompted before it is overwritten.

     There can be up to 20 $AUTO-REPLACE lines, and up to 14 file names on
     each line (separated by semi-colons). No wildcards are allowed on these
     lines, and only the file names should be specified (i.e., no paths).


     e.g., -

        $AUTO-REPLACE=PROG1.EXE;PROG1.DLL;PROG4.DLL;MYPROG.INI
        $AUTO-REPLACE=RATTER.RAT;RETTO.RET;DRAT.DRA
        $AUTO-REPLACE=ROTTO.ROT;ROUTER.RUT;TROUBLE.HUT



    RESERVED WORD
    *************

    $INI
    ----
    This is used to specify any ASCII files that configuration information
    should be written into. Normally, these will be INI files of some sort,
    but they can be any file, as long as it is in ASCII format.

    You have have up to 20 "$INI" lines - and each line MUST be in the format
    prescribed below;
       * each line must contain 4 entries - each separated with a semi-colon

       [a] the first entry is the NAME of the file to be written to - a full
           path must be supplied - otherwise, the file is presumed to be in
           the WINDOWS directory. You can use "$DEST" here, to specify files
           in the directory tree of the target directory.
           If the file does not exist, it is created.
       [b] the second entry is the title of the section ("Application name"
           in Windows API speak) that should contain the entry.
       [c] the third entry is the name of the entry you wish to make ("Keyname"
           in Windows API speak)
       [d] the fourth entry is the string that you wish to associate with the
           entry.

     - e.g.,
          $INI=C:\AUTOEXEC.BAT;MYPROG;SET PROGDIR;$DEST
          $INI=$DEST\MYPROG.INI;CONFIG;STARTUP;PROG.EXE /FE=XDS.XCL
          $INI=WIN.INI;EXTENSIONS;GFD;$DEST\BIN\GFD2.EXE ^.GFD


    RESERVED WORD
    *************

    $GROUP
    ------
    This is used to specify the DEFAULT name of the Program Manager Group
    in which the icons will be created. This can be the name of an
    existing group (e.g., "Accessories", "Main", etc.) in which case,
    the items will just be added to the ones already in that group.

    However, you may specify a completely new group. If this does not
    exist, it will be created (e.g., "MyProgram").

    You can have only ONE such line - but you can specify other group
    names for different icons in the $ICON reserved word.


    RESERVED WORD
    *************

    $ICON
    -----
    This is used to specify the names of the files for which you want
    Program Manager icons to be created. There can be a maximum of 45 icons.

    Each $ICON line should contain only ONE entry. This is the name of the
    file to create an icon for (this could be a program file plus a
    parameter or any other file). This should be followed by a semi-colon,
    and after the semi-colon, the title that Program Manager should give to
    the icon, and (optionally), preceded by a semi-colon, the name of any
    other group (i.e., if different from the one in the $GROUP reserved word)
    that the icon should be created in.

          e.g.,
          $ICON=MYMAIN.EXE;Cool Prog v1.20
          $ICON=BACKUP.EXE;Backup Applet;Accessories
          $ICON=WINHELP.EXE MYPROG.HLP;My help file
          $ICON=NOTEPAD.EXE ORDER.FRM;Order Form
          $ICON=NOTEPAD.EXE REGISTER.TXT;Registration documentation
          $ICON=NOTEPAD.EXE README.TXT;Readme file



    RESERVED WORD
    *************

   $EXEC
   -----
   This line is optional. It specifies the name(s) of any program(s) that
   should be run immediately after the installation is completed (with any
   optional parameters to be passed to the programs). You can have only ONE
   such line.

    - e..g.,

        $EXEC=CONFIG.EXE

    You can put as many as 5 programs on this line. In such cases, each
    one must be terminated by a semi-colon

    - e.g.,

        $EXEC=CONFIG.EXE /DIR=C:\TEMP; MYPROG1.EXE; MYPROG2.EXE /NEW

       In the above example, there are 3 programs to be run. The first
       and the third are run with parameters, while the second one has no
       parameter.


   $PRE-EXEC
   ---------
   This line is optional. It specifies the name(s) of any program(s) that
   should be run during the installation, as part of the installation
   process. These programs will be run immediately after the files have
   been copied from the disks. Install will try to wait for these programs
   to terminate, before continuing. Such attempted waiting will work for
   Windows programs, but will fail if used to run DOS programs under OS/2.

    - e..g.,

        $PRE-EXEC=EXPAND.EXE $DEST\REE.BIN


   $CLEANUP
   -------
   This is optional. It specifies the name(s) of any temporary files(s)
   that should be deleted after the installation. Such deletions (if any)
   will be done immediately after any $PRE-EXEC lines have executed
   and returned. If there is no $PRE-EXEC line, then the deletions will
   be done after the $INI lines have been processed. If there are no
   $INI lines, then the deletions will be immediatelt after the $DISK
   lines have been processed.

   If the specified files do not exist, they are simply ignored.

   There can be up to 20 $CLEANUP lines. Each line should contain only
   ONE entry. The only other reserved words permissible on these lines
   are $DEST and $TEMPDIR. I will *never* add $WINDIR or $SYSDIR to this
   list, because I can see no reason why one would want to delete files
   from people's Windows or SYSTEM directories.

   Use this reserved word with care. I accept no responsibility for any
   problems caused by using it.

    - e..g.,

    $CLEANUP=$TEMPDIR\4EDE6.$$$
    $CLEANUP=$TEMPDIR\54DE6.$$$
    $CLEANUP=$DEST\TEMPFIL.INI


   The $TEMPDIR can be used here with the Install program files in cases
   where you choose to use SETUP.EXE as a loader - e.g.,

    $CLEANUP=$TEMPDIR\INSTALL.EXE
    $CLEANUP=$TEMPDIR\WINSTALL.INF
    $CLEANUP=$TEMPDIR\WINSTALL.HLP

   This way, Install can cleanup the files which have been copied by
   SETUP.EXE to the TEMP directory.


    RESERVED WORD
    *************

   $WINDOW
   -------
   This line is optional. It should specify whether you want Install to
   start up maximized or not. If the entry here is "MAXIMIZE" then Install
   will start maximized - otherwise it will just start normally.
   You can have only ONE such line.


   RESERVED WORD
   *************

   $NO-END-DIALOG
   --------------
   This line is optional, and is not very useful. All it does is to
   suppress the final dialogs which inform the user about whether the
   installation was successful or not, and that the installation is
   completed. The default behaviour of Install is to present these
   dialogs to the user. Use this reserved word to disable that feature.
   If this feature is used, the warning dialog that comes up if the size
   of the files actually installed is less than 98% of the size stated in
   the $SPACE reserved word is also disabled.
   This line takes no parameter.


   RESERVED WORD
   *************

   $NO-PATH-DIALOG
   ---------------
   This line is optional. It disables the dialog box which asks the
   user whether the target directory should be added to the PATH
   statement in AUTOEXEC.BAT. The default behaviour is to present this
   dialog. Use this reserved word to disable that feature.
   This line takes no parameter.


   RESERVED WORD
   *************

   $SETCHECKBOX
   ------------
   This line is optional. It automatically checks the checkbox titled
   "click here to create Program Manager item".
   This line takes no parameter.



   RESERVED WORD
   *************

   $COPYBUFFER
   -----------
   This line is optional. It sets the size of the buffer used by Install
   to copy the files. The buffer size should be a whole number,
   representing the number of BYTES to be used. This number MUST be
   between 2048 and 32760. If it is set lower than 2048, then Install
   will replace the supplied value with 2048 - and if it is set higher
   than 32760, then Install will use 32760.

   The higher the buffer, the faster the files are copied. However, the
   buffer size also dictates;
     [a] the frequency with which the "percent" meter is updated
     [b] the frequency with which Install will "yield" the CPU and allow
         Windows to do other things (each time COPYBUFFER bytes are copied,
         Install "yields" for 128 milliseconds.

   Therefore, if the number is set too high, the percent meter
   will not be updated frequently enough, and the display might look odd.
   If, on the other hand, the setting is very low, then the percent meter
   will be updated frequently, but the file copying will become much
   slower.

   The DEFAULT value is 8190, and this will be used if this setting is left
   empty. I suggest a setting of 16384 (i.e., 16kb) as a good setting
   which adequately compromises between speed of copying, and the frequency
   of the progress bar's being updated.

        - e.g.,

             $COPYBUFFER=4095


   RESERVED WORD
   *************

   $WINDOW-BACKGROUND
   ------------------
   This line is optional. It can be used to set the background color
   of the main window of the Installer. The default is to have a white
   background. Because the background is a Windows brush handle, the
   only valid values for this setting are 0,1,2,3, or 4
       0 = White
       1 = Light Grey
       2 = Grey
       3 = Dark Grey
       4 = Black

   If you use this to change the window background, be sure to also set
   the $TEXT-BACKGROUND (below) to an appropriate setting. For example,
   if this setting is 1 (light grey) then the text background should be
   set to 192,192,192 (so that the window and text backgrounds should
   match).

   e.g.,

   $WINDOW-BACKGROUND=1
   $TEXT-BACKGROUND=192,192,192

   $WINDOW-BACKGROUND=2
   $TEXT-BACKGROUND=128,128,128



   RESERVED WORD
   *************

   $TEXT-BACKGROUND
   ----------------
   This line is optional. It can be used to set the background color
   of the text in the main window of the Installer. The default is to
   have a white background.

   The color used here can either be;
     [a] one long integer value (you can use hexadecimal values in
         Pascal notation) - see below for explanation
     or
     [b] three values represent RGB (red, green, blue) values.

   If using RGB values, they should be separated by commas, or
   semi-colons (e.g:  128,128,128 - for a dark gray background)

   If using a hexadecimal value (those that begin with $00 and then
   are followed by SIX values). The SIX values here represent
   Blue, Green, Red - or reversed RGB. In this respect, "FF" turns the
   color to full intensity, "00" turns it off, and any other value
   varies the intensity.

   Note that the color that results from any value depends on the
   display driver of the user (particularly the number of colors).
   For a 256 color setup, you can use the following values;

          White       : $00FFFFFF
          White       : 255,255,255

          Black       : $00000000
          Black       : 0,0,0

          DarkGray    : $00808080
          DarkGray    : 128,128,128

          Red         : $000000FF
          Red         : $255,0,0

          Blue        : $00FF0000
          Blue        : 0,0,255

          DarkRed     : 128,0,0
          DarkRed     : $00000080

          DarkPurple  : 128,128,240
          DarkBlue    : 0,0,150
          Purple      : 200,0,200
          Light Cyan  : $00FFFF00
          Green       : $0000FF00
          Yellow      : $0000FFFF
          Magena      : $00FF00FF
          LighGray    : $006F9FFF
          Gray        : $006688FF


    e.g.,
         $TEXT-BACKGROUND=128,128,128
         $TEXT-BACKGROUND=$00FFFFFF




   RESERVED WORD
   *************

   $PAINTDIALOGS
   -------------

   This line is optional. It is for use in those cases when you want the
   status dialogs to be painted with the same text and background colors
   as the main Install window (the default is that the status "percent"
   dialogs have a white background).

   You should not use this reserved word if you have not changed the
   window background and the text background.

   This line takes no parameter.



//////////////////////////////////////////////

    LICENSE
    -------
    CHIEF'S INSTALL IS MOST CERTAINLY *NOT* FREE SOFTWARE.
                       ^^^^^^^^^^^^^^^^^^^^

    A lot of work has gone into it to make it what it is now. Chief's
    Install is released as "ChiefWare". This means that you may use and
    supply it as the installation routine for any of your applications,
    as long as;
    -----------

       [1] You offer me a FREE REGISTERED COPY of any application(s) that
           you supply it with, and, if I am interested in it, you send me
           a free copy. This point only applies to shareware and freeware
           applications

       OR, if your application is a commercial application,
           you send me a nice and *unique* postcard from your area

       AND,

       [2] My name does NOT appear ANYWHERE in your application's
           documentation - I am not interested in answering any questions
           from any of your customers.

    You may also distribute it freely - as long as;

       [1] ALL the files which I have supplied are included, and
       [2] NO ATTEMPT is made to modify or alter ANYTHING in any of the
           files (this restriction does not apply if you are only using
           the relevant copy of INSTALL.EXE and/or SETUP.EXE as your
           application's installation program).
       [3] You do not charge ANYTHING for distributing this package (disk
           vendors may charge a reasonable fee, not exceeding $5 (US) for
           media and duplication).


    Please note the disclaimers below.

    DISCLAIMER
    ----------
    I do NOT warantee ANYTHING concerning any of the programs or files
    which make up Chief's Install. I accept NO RESPONSIBILITY for ANY LOSS
    OR DAMAGE of ANY kind, including, but not limited to, losses of a
    physical, mental, social, financial, marital, or of whatever nature,
    resulting from the use, or the purported use of Chief's Install, or
    any of the files in the package, for any purpose whatsoever. I do not
    even warantee that it will not kill you.

    You use Chief's Install ENTIRELY AT YOUR OWN RISK, and you supply
    it to your customers, friends, family, acquaintances, or enemies,
    ENTIRELY AT YOUR OWN RISK.

    If these terms are not acceptable to you, then please DELETE all
    the files from your disks IMMEDIATELY.


    BUGS
    ----
    There may be bugs in the program, although I do not know of any extant.
    I welcome bug reports. I will try to fix them if I can. If I cannot
    fix them, then sorry.


    Contact address:
    ----------------
    Dr. Abimbola Olowofoyeku
    268 Horwood
    Newcastle
    Staffs, ST5 5BQ
    ENGLAND

    Email: laa12@keele.ac.uk



      -------------------------------------------------------------
      Dr. A. Olowofoyeku (The African Chief and The Great Elephant)
      November 1994
      -------------------------------------------------------------

