Ssetup32 ver. 4.70, (c) by Davor Zorc, Zagreb, Croatia, 2004.

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

CREATION OF SETUP DESIGN

Quick customization

1. Copy Setup.exe to a work directory of your application (for example to c:\SET_OUT\WORK). ALL of your application files should be in that work directory (regardless if they should be installed elsewhere).

Or, you start by clicking on "Edit Design" icon in Ssetup group 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  README.TXT and /or LICENCE.TXT using menu Edit/ Ed.Readme/ Licence file. Those files will be readable during installation clicking the Setup [Readme/Licence] button. Add those files to Output list. Click on menu Edit/ Edit logo to edit logo picture SETLOGO.BMP visible on the main window.

4. press  [Auto Make] button for express design generation. Give name for this application. General data (SetData) will be automatically filled-up and Output list (which is located bottom-right on Design form) will be made too. 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. 

Remark: If your application in work directory have subdirectories, you have to set Options/ Auto Make with subdir option to include those files in [Auto Make] (if you plan to make ZIP distribution package it is also good to activate Options/ Make ZIP with subdir). If there are files with same names in different subdirectories there might be some name conflicts, so consider renaming them. 

5. To fine tune your design, edit SetData lines which are at top-right on Design form (see sample below).

When done, click [Save All] button.

6. You may want to distribute your application in 3 forms:

  1. Set of files - choose menu Distribution /Create Output Disk1,2. Distribution directory is c:\SET_OUT\Applicname.
    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.
  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, SSIP.EXE is installed on your computer. If you do not want to use SSZIP.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. Alternatively you might use other package like  SFX Maker (freeware). 
    When user click on distribution EXE file, all files will be extracted to Windows temporary directory, Setup.exe will be activated, installation will be done and finally, files from temporary directory will be deleted.

 

 

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:

  1. manually editing line by line and pressing [Add^]
  2. automatically with menu option [Auto Make] or
  3. 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^].

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 use menu Distribute/ Create Output disk 1,2,3. 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 several chunks (use compression on those files).

5. Other options set through SETDATA editor:

 

REMARKS AND LIMITATIONS

 

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
Form_Color=$00FF8080
Ask_Overwrite=0
Run_Program=0
Ask_Licence=0
Check_DiskFree=0
Source_Size=0
SpaceNeed=155
UseRegRunOnce=0
FullScreen=1

- 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,Dummy Application    ;copy & make icon named "Dummy Application"
>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 this 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
;-----------------------------------------------------------------------------
 

 

INSTALLATION (GUIDE FOR END USERS)

NOTES:

 

UNINSTALL (GUIDE FOR END USERS)

 

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 register 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: click here (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 6 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/, under >Programming - install Installation/ Uninstall Programs
 

<------------------------ cut order form here --------------------->
___________________________________________________________________
Registration form for : SSetup32
___________________________________________________________________
Name:____________________________ Address: ________________________
City, State: ____________________________ Country: ________________
Zip:__________________ E-mail: ____________________________________
Your Home page:____________________________________________________
Program delivery: e-mail [ ] CD-ROM disk [ ]
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:

 

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.

 

  • Features
  • Installation
  • Uninstall
  • Customization of setup design
  • Acknowledgments
  • Remarks and limitations
  • Sample files
  • Legal
  • Registration and updates
  •  

    Go back to Ssetup HomePage