Ssetup32 ver. 4.00, (c) by Davor Zorc, Zagreb, Croatia, 2002.







      * Features        * Installation     * Uninstall

      * Customization   * Acknowledgments  * Remarks and limitations

      * Sample files    * Legal            * Registration and updates

General purpose Win95/98/XP installation /uninstall utility. It will check
available space on the chosen drive, create target directories and copy
files to them and the Windows directories, create the Program group and
start the target application. There is a separate version of this program
for Win3.1x systems.

FEATURES

   * creates single file distribution (EXE or ZIP)
   * small size (cca 150 kB)
   * program may be used to install DOS, Win3,1x, Win95/98 or Win XP
     applications
   * Setup, Uninstall and Setup design are all contained in a single file
   * copy/delete files, create/remove desktop group
   * uncompress files compressed with Microsoft compress
   * easy configuration/customization for your project
   * insert your own picture logo
   * Setup program is secure: install information is scrambled and
     unreadable.
   * create nested directories to any depth
   * create multiple target sub directories and place files in them
   * split to multiple source media
   * insert your own (c) copyright in the Setup window (for registered
     users)
   * shareware version is not crippled or limited in any way
   * puts main application icon on Windows desktop
   * uninstall through Settings/Control Panel/Add-Remove Programs
   * upgrade new version of application to the same directory

INSTALLATION (GUIDE FOR END USERS)

   * If you have ZIP distribution file (xxxxxxx.zip) unzip it to some
     temporary directory.
   * Start Setup program. Choose Directory and program Group or just leave
     it as it is.
   * Click on [Start Installation].  During installation you can abort it
     by clicking on [ABORT SETUP] button.
   * When setup is finished click on the Application icon.

NOTES:

   * If you do not wish to make a new program group, or if you do not want
     new icons to be added in an existing group, click checkbox [x] Skip
     group.
   * If you want that Setup asks you before overwriting files which are
     already on the system or before using existing directories, check [x]
     Ask overwrite.
   * If you want that application starts running when Setup finish, check
     [x] Run program.
   * You do not need to uninstall any old version before installing a new
     one in the SAME directory.
   * In Win95/98/NT program Group is accessible under 'Start', 'Program
     Files'.

UNINSTALL (GUIDE FOR END USERS)

   * To uninstall click on UNINSTALL icon in program group or go to Start/
     Settings/ Control Panel/ Add-Remove Programs.
   * SETUP.EXE is copied to the target directory to act as UNINSTALL. It
     will delete files specified in SETUP list and remove its Group. After
     that it will try to delete the target directory. If there are other
     files in that directory it will not delete them or the directory.
   * Setup will ask before removing files from Windows system directories.
   * If you installed icons in one of existing groups (shared with other
     applications) answer No when Setup ask to remove that group.

CUSTOMIZATION

Quick customization

1. Copy Setup.exe to a work directory (say, C:\WORK). Then copy ALL of your
application files to that work directory.

Or you click on "Edit Design" icon and browse to the Work directory.

2. Run Setup. Double-click twice on "Ssetup" logo text in the top left
corner of Setup window. This opens Design form window.

3. Write a README.TXT using menu Edit/ Ed.Readme file button. This file
will be readable during installation clicking the Setup [Readme/Licence]
button.

4. Edit SETDATA lines which are at top-right on Design form. Change it to
suit your application (see sample below).

5. Quick way to build Output list (which is located bottom-right on Design
form) is to Project/ Auto Make menu and the list will be made. By default
all EXE, TXT and HTM files will get an Icon in the group. By default all
files will be copied to the Target directory.  If your application in work
directory have subdirectories, you have to set Options/ Auto Make w.subdir
option to include those files in [Auto Make>]. If there are files with same
names in different subdirectories there might be name conflicts. In that
case use menu Options/ Make ZIP w.subdir.  When done, click [Save All]
button.

6. You may want to distribute package in 3 forms:

  1. Set of files - choose menu Distribution /Create Output Disk1,2.
     Distribution directory is c:\set_out\Applicname.
  2. ZIP archive - Click on [ > ZIP] if you wish to produce single ZIP
     archive file for distribution of your program. To be able to produce
     archive, ZIP.EXE is installed on your computer. If you do not want to
     use ZIP.EXE you may create ZIP archive using PowerArchiver
     (www.powerarchiver.com) or  WinZip (www.winzip.com) or other archiver.
     ZIP file is created in distribution directory c:\set_out\Applicname.
  3. self-extracting EXE file - After making ZIP, click on [Zip > Exe]
     button. Alternativelly you might use other package like  SFX Maker
     (freeware). Clicking on EXE,  files will be extracted to Windows
     temporary directory, Ssetup.exe will be activated, installation will
     be done and finally, files from temporary directory will be deleted.

7. Try your Installation by running Setup from distribution directory
c:\set_out. Try Uninstall by clicking on Uninstall icon in target group.
This testing is best done on another computer - to be sure that all
necessary files have been included in package.

Customization details

1. Output file list is stored in SETDATA.EZZ in an UNREADABLE form. It
lists files and directories to be installed. Using Design form it can be
created in 3 ways:

   * manually editing line by line and pressing [Add^]
   * automatically with menu option Auto Make or
   * imported finished project from *.EZZ file by using menu Project/ Load
     from.

Files SETUP.EXE and SETDATA.EZZ must be listed in the output file list. Do
not distribute other Setup files.

Editing of entries is done in Edit line on the bottom middle of the design
form. Clicking on Available file list (on the left) or Output  list (on the
right) copies clicked line to edit line. Also radio-button above edit line
shows what will be done with this file/ directory entry. You may click
radio button to change "do what character". After editing you may put that
line in Output file list by clicking [Add^] or [Replace^].

  1. Before each file name line insert a "do what character". It instructs
     SETUP what to do with that file/ directory (See below).
       1. Put + character in front of file name for files which must be
          copied and an icon made. Optionally append description which
          should appear under icon (example : +DUMMY.EXE,Dummy
          Application).
          Remark: If description ends with ^ character, this icon will also
          appear on Windows Desktop.
          Warning: if you have more than one items with same file name
          (example : DUMMY.EXE and DUMMY.TXT) you must add the description,
          because without it Windows will make only one icon instead of
          two. It is also possible to specify alternative icon name and
          other details as described in Windows programming guide for
          AddItem() function on DDE conversation with WIndows Progman.
       2. Put - for files which must be copied to target directory
       3. Put = for files which must be copied to Windows directory
       4. Put ~ for files which must be copied to Windows System directory
       5. Put . for files which are not copied but may be generated by
          application and need to uninstall
       6. Put > for executable file which must be executed after
          installation is finished (must also be under + or -)
       7. Put ! for files which must be deleted from old version before
          installing new one
       8. Put \. for a directory which must be created on target directory
       9. Put \\ for a directory which must be created on target drive root

2. Apart from Target directory additional directories may also be created:

  1. as sub directory of the Target directory (example: tag \.DOC, see
     below example Output list). To copy a file to that directory use
     notation  -DOC\FILE.EXT.
  2. as an entry in root of target DRIVE (example: tag \\TEMP\PIPI). To
     copy a file to that directory use -\TEMP\PIPI\File.DAT. On your source
     disk this File.DAT file must also be in the work directory  (not in
     specified sub directory). This is also true for any files going to
     Windows or System directories.

3. Compressed files support

If file extension is finished with _, it is supposed that it was compressed
with 'compress -r filename' command (Microsoft COMPRESS.EXE DOS utility).
Ssetup will uncompress those files (File.ex_ --> File.exe). Do not compress
Readme.txt so that user can get this information before installation.

4. Multiple source media support

When making installation on diskettes, there is a size limit of each media.
Before doing this option edit SETDATA line: Source_Size=value. Value is the
size of diskette in kB (if this feature is not needed, set value to zero).
To create source installation files for Diskette1, Diskette2, click on
button [Save All] then [> Out]. Files will be created in c:\set_out
directory in subdirectories Disk1, Disk2,..etc. You can copy those
subdirectories to individual diskettes. Testing of installation may be done
executing Setup.exe in disk1 subdirectory. Keep in mind that Setup would
not split a file larger than diskette size to sevaral chunks (use
compression on those files).

5. Other options set through SETDATA editor:

   * Ask_Licence=0 -If wish that installation is not possible untill user
     accept licence text put value 1
   * Ask_Overwrite=0 -If you want that Setup asks you before overwriting
     existing files or using existing directories put value 1
   * Run_Program=0 -If you want that application starts running when Setup
     finish put value 1
   * Check_DiskFree=0 -If you want that Setup checks for free target disk
     space put 1
   * put <program files> in Def_path to specify dafault programs directory
     on any system (usually expands to "c:\Program Files")
   * Click on menu Project/Edit logo to edit logo picture visible on the
     main window

REMARKS AND LIMITATIONS

   * While uninstalling, all specified files are removed from the target
     drive. (from the target directory, other created directories and
     Windows directories.) Setup will ask before removing files copied to
     Windows directories since they might be shared.
   * Program does handle multiple source disks (floppies) in a way that it
     prompts user to insert next disk when a source file is not found.
   * Setup does read /write Windows registry but only in a list of programs
     to be uninstalled.

SAMPLE FILES

- sample SETDATA :

[main]
ApplicName=Ssetup Dummy
Def_path= <program files>\Dummy
Def_Group=Ssetup Dummy Group
Head_Text=Dummy Application, ver. 1.00
Ver=1.00
Producer=Davor Zorc
Ask_Overwrite=0
Run_Program=0
Ask_Licence=0
Check_DiskFree=0
Source_Size=0
SpaceNeed=155

- sample Output list (or *.LST file to import):

;-----------------------------------------------------------------------------
; SSETUP- comment lines begin with ; in colon 1
; Text on all lines must begin at column 1.
; + = copy & icon, - = copy, = = copy WinDir,
; . = no copy, ! = delete, > = run, \ = dir
;
;------------- files for Setup/ Uninstall ------------------------------
+SETUP.EXE        ;copy and makes icon for SETUP (for Uninstalling)
-SETDATA.EZZ        ;this file is copied and updated in target directory
;
; ------------ list of files to copy/ remove --------------------------
;
!DUMMY.TMP        ;delete if exist on target dir. from previous installation
+README.TXT
+DUMMY.EXE        ;copy & make icon
>DUMMY.EXE        ;run this after installation (must also be after +)
-DUMMY.RES        ;copy only
=DUMMY.INI        ;copy to Windows directory
.DUMMY.TMP        ;for uninstall-file generated later (by application)
-DOC\FILE_ID.DIZ  ;put in sub-directory of target directory
;
-\DATA\PIPI\F.DAT   ;copy to directory on target drive
~DUMY.DLL  ; copy to Windows \SYSTEM directory
;
;------------- make Directories ----------------------------------------------
;
\.DOC             ;create extra sub-directory in Target directory
\\DATA\PIPI       ;create absolute directory on Target drive
;-----------------------------------------------------------------------------

REGISTRATION

This program is unregistered SHAREWARE and requires payment to the author.
It is the full feature version and free to test for one month. It is
illegal to use this program in your distribution package without prior
registration. To registrate please send completed form together with cash
(in opaque envelope) or a banker's check payable to:

Dr.sc. Davor Zorc
Bosiljevska 34
10 000 Zagreb
Croatia (Europe)

Author e-mail: davor.zorc@fsb.hr (comments and suggestions are welcome !)

PRICE FOR PERSONAL USE : 20 US$ or equivalent in convertible currency. This
is the price for shareware authors to use it to distribute one product
(program) title.

PRICE UPGRADE PERSONAL USER: 5 US$ or equivalent in convertible currency.

PRICE FOR CORPORATE USE : 150 US$ or equivalent in convertible currency.
This is the price to use it to distribute more product types under one
producer name.

Experience shows that personal checks or bankers checks from USA and
European Union banks are accepted. EuroChecks and postal checks (money
orders) are NOT accepted. You will receive the latest version by e-mail and
the instructions on how to make your own copyrighted Setup. You will also
receive free registered upgrades for at least six months.

Latest version may be found at Ssetup Homepage:
http://www.fsb.hr/~dzorc/ssetup.html.

See the author at Author's homepage http://www.fsb.hr/~dzorc

Publication place in the world is: http://www.simtel.net/simtel.net/, under
>Programming - install Installation/ Uninstall Programs


<------------------------ cut order form here --------------------->
___________________________________________________________________

Registration form for : SSetup32

ssetu400.zip Ssetup: small win95/98/NT setup + uninstall

___________________________________________________________________

Name:____________________________ Address: ________________________

City, State: ____________________________ Country: ________________

Zip:__________________ E-mail: ____________________________________

Your Home page:____________________________________________________

Program delivery: e-mail [ ] 3 1/2" diskette [ ]

Included US$:_____________ cash [ ] check [ ]

Comments, suggestions for future updates, bugs, complaints:

___________________________________________________________________

___________________________________________________________________

___________________________________________________________________

Where did you get this file:

___________________________________________________________________

<------------------------ cut order form here --------------------->

LEGAL

This program is tested and believed to be free of bugs. There is however no
guarantee that this program will perform its expected duty, and that it
will not damage your machine, data or user in any way.

Mentioned hardware and software products are (C) of their producers. This
program is SHAREWARE and requires payment to the author. Commercial use
requires license by the author.

You may re-distribute complete unmodified package to BBS, Internet, CD-ROM,
providing:

   * no money is charged for this program
   * you must email the author what version you are going to publish and in
     what product (so the author is able to send new version).

ACKNOWLEDGEMENTS

- ZIP.EXE is a product of Info-ZIP (see licence by Info-ZIP)
- Self-Extracting EXE module is based on Carl Bunton's example ZIPSFX_S.ZIP

- Many thanks to Peter Rader for his suggestions and beta testing.

Go back to Ssetup HomePage
