		DOCUMENTATION FOR ChiefPro MAKESFX
		----------------------------------

** Please read the disclaimer section of this file before attempting to use
MAKESFX.
***

MAKESFX is a Win32 console program for the purpose of manual creation
of Chief's Installer Pro self-extracting (SFX) ZIP files. 

ChiefPro supplies a proprietary self-extract stub (STUBSFX.EXE) with
MAKESFX.EXE for this purpose. These files are in your Chiefpro\UTILS 
directory.

**** NOTE: ****
The ChiefPro SFX format is proprietary and is *NOT* compatible with other 
ZIP SFX formats. Although the programs work only with standard ZIP archives, 
the SFX files that are created by using MAKESFX are of a different format from
those created by other ZIP SFX tools, and cannot be manipulated with other ZIP 
SFX tools.

For the purposes of manual creation of a self-extracting archive, the
following program files can act as the STUB executable passed to
MAKESFX.EXE: 

	[a] STUBSFX.EXE, or 
	[b] ChiefPro's SETUP.EXE, or
	[c] MAKESFX.EXE itself. 

No other executable will suffice.

From your ZIP files, all three will create Windows based self-extracting 
.EXEs (including support for long filenames in your ZIP file when running
under Windows 9x and Windows NT). 

The SFX STUB that you choose for any particular ZIP file depends on
your purpose. Either STUBSFX.EXE or SETUP.EXE will suffice for a Windows
installation. STUBSFX.EXE will do the job if you want the user to be able to
decide whether or not to run an installation program after extracting the
files from the .EXE archive. SETUP.EXE is best for a proper ChiefPro
installation - but for this purpose, you would be best advised to use the
ChiefPro IDE facilities.

USAGE
-----
The syntax for MAKESFX is:

[1] MAKESFX <ZipFile.ZIP> <Target Dir>

In this format, MAKESFX just acts as a (very basic) unzip tool.

or  

[2] MAKESFX <[/S /L /X /E]>  <parameters>

This is the recommended usage of MAKESFX. In this way, the tool can be
used to create or manipulate ChiefPro SFX files.

LEGEND:
-------
1.   Add SFX stub to a ZIP archive to produce SFX file:
     (and optionally run a program after extracting the files)
     Syntax:
       MAKESFX /S <Stub> <ZipFile> [SFX.EXE [EXE-to-run] [/S:password]] [/CFG=<CfgFile>]

     Examples:
       MAKESFX /S setup.exe project1.zip MYPROG.EXE
       MAKESFX /S setup.exe project1.zip MYPROG.EXE INSTALL.EXE
       MAKESFX /S stubsfx.exe project2.zip /S:MyPassWord

    NOTES:
    a. The "EXE-to-run" parameter is ignored if SETUP.EXE is used as
       the STUB. SETUP will always run INSTALL.EXE.

    b. The "/CFG=inifile" parameter is designed to allow the user to
       customise the caption and message of the SFX dialog when SETUP.EXE
       is used as the STUB. You can omit the "/CFG" parameter if you name
       your CFG file "MAKESFX.INI". The program will default to looking for
       configuration information in "MAKESFX.INI", unless you override that
       name with "/CFG".


       Example:
         MAKESFX /S stubsfx.exe project2.zip /CFG=project2.cfg

       Contents:
        If you use a CFG file, it should contain at least TWO entries in a
        section called "Custom". These two entries are "Caption" and
        "Message" to specify the dialog's caption and message respectively.
        Optionally, a password can be supplied in an entry called "Password".

        For example, such a CFG file would contain entries such as these;

        [Custom]
        Caption=My Great Program Self-Extracting .EXE
        Message=My Great Program's Setup is extracting the support files for this installation.\nPlease wait ...
        Password=E5sd!34xgw

        NOTE: "\n" indicates a line break (a new line).

2.   List the contents of any ZIP archive:
     Syntax:
       MAKESFX /L <ZipFile.ZIP>

     Examples:
       MAKESFX /L project1.zip
       MAKESFX /L chief522.zip

3.   Extract the ZIP archive inside this current ChiefPro SFX file
     into a ZIP file: (only for those SFX files for which MAKESFX.EXE
     itself is the SFX stub)
     Syntax:
       MAKESFX /X <ZipFile>

     Examples:
       MYPROG /X test.zip
       project1 /X project0.zip

4.   Extract the Zip archive from another ChiefPro SFX file, into ZIP file:
     Syntax:
       MAKESFX /E <SFX-File> <ZipFile>

     Examples:
       MAKESFX /E project1.exe test.zip
       MAKESFX /E myprog.exe myprog.zip


INITIALISATION SCRIPTS
----------------------
MAKESFX can be operated entirely in conjunction with an INITIALISATION
file or script. This file will contain ALL the parameters which you
wish to pass to MAKESFX, bearing in mind these points;
   [a] each parameter must be on a single line by itself
   [b] the parameter list must appear in the correct order (see "LEGEND"
       above) - otherwise, there *WILL* be confusion, and the result will
       be unpredictable.

If this facility is used, MAKESFX can take only one parameter - the name
of the initialisation file/script, preceded by the "/F=" parameter:
   "/F=<IniFile>"

   Example;
     MAKESFX /F=C:\Chief\Project1\Project1.INI

The format of the script file is as follows

1. As stated above, each parameter must be on a single line by itself,
   and the parameters must be listed in the correct order.

2. Comment lines begin with either "//*", or a semi-colon, or a hash ("#").
   Any line beginning with any of these will be ignored;

   Examples:
      //* -- this is a comment line
      ; ---- so is this line!
      # ---- and this line!

3. You can refer in the script to command line parameters with the "%"
   sign (e.g., "%2" - to refer to the second parameter passed at the
   command line). Remember that the "/F=IniFile" parameter itself is the
   FIRST parameter - so you should never refer to "%1" in your script.

EXAMPLES of the contents of a MAKESFX script file;
------------------

1.
	; 1. create an SFX file
	/S
	;
	; 2. Use STUBSFX.EXE as the stub
	STUBSFX.EXE
	;
	; 3. The ZIP file is PROJECT1.ZIP
	PROJECT1.ZIP
	;
	; 4. produce a self-extracting .EXE called ALPHA20.EXE
	ALPHA20.EXE
	;
	; 5. Run INSTALL.EXE at the end, using ALPHA20.INF instead of WINSTALL.INF
	INSTALL.EXE ALPHA20.INF
------------------

2.
	; 1. create an SFX file
	/S
	;
	; 2. Use STUBSFX.EXE as the stub
	SETUP.EXE
	;
	; 3. The ZIP file is PROJECT1.ZIP
	PROJECT1.ZIP
	;
	; 4. produce a self-extracting .EXE called ALPHA20.EXE
	ALPHA20.EXE
	;
	; 5. Get user messages from a file
	/CFG=C:\MYPROG\MYPROG.CFG

------------------

DISCLAIMER
----------
MAKESFX.EXE and STUBSFX.EXE are supplied AS IS - and WITHOUT ANY WARRANTIES
WHATSOEVER. They are not an integral part of Chief's Installer Pro-32, and are
supplied, as extras, only as a result of a specific request. You use both or
either of them ENTIRELY AT YOUR OWN RISK.

If these terms are not acceptable to you, then you have no license to use
either of these programs, and YOU SHOULD PLEASE DELETE THEM FROM YOUR DISKS
IMMEDIATELY AND PERMANENTLY.

Prof A A Olowofoyeku.
-------------------

