Program Ssetup32, (c) by Davor Zorc, Zagreb, Croatia, 2009.

General purpose Win95/ 98/ XP/ Vista 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 directory c:\SET_OUT\WORK). ALL of your application files should be in that work directory (regardless if they should be installed outside the Target directory).

2. Run Setup.exe. Double-click twice on "Ssetup" logo text in the top left corner of Setup window. This shows [Edit Design] button which opens Design form window.

Alternative to steps 1. and 2. is to go to Programs/ Ssetup Dummy Group and click on "Edit Design" icon. Then browse to the desired WORK directory. When Setup.exe opens, click on  [Edit Design] button.

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; .HTM; .CHM; .URL; .HLP; .PDF; .RTF; 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 files in 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/ Create 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. Multiple volumes (Disk1, 2, 3,) are created by specifying option Source_Size (see Customization details).
  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, SSZIP32.EXE (by Info-Zip) is installed on your computer. If you want to use more powerful program then SSZIP.EXE you may create ZIP archive using PowerArchiver (www.powerarchiver.com) or  WinZip (www.winzip.com) or WinRAR (www.win-rar.com) archiver. ZIP file is created in the distribution directory c:\set_out\Applicname.
  3. self-extracting EXE file - After making ZIP, click on [Zip > Exe] button. Alternatively you might use other application to convert ZIP archive to SFX EXE file (for example WinRAR). 
    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.

Try your Installation by running distribution package 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:

  1. manually editing line by line and pressing [Add^]
  2. automatically with menu option [Auto Make] or
  3. load finished project from *.EZZ file by using menu Project/ Load from.
  4. import finished project from readable list *.LST file by using menu Edit/ Import design.

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 list 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^]
You can also add multiple files at once by multi-selecting several files (use Shift and Ctrl keys) in Available file list and clicking  [Add^]. Output file list is also multi selectable for Deleting lines.

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.
    Remark1: you can optionally append description which should appear under icon (example : +DUMMY.EXE,Dummy Application).
    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.
    Remark2: If description of any file line ends with ^ character, this icon will appear on Windows Desktop. 
  2. Put - for files which must be copied to target directory (no icon made)
  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 must be copied to current user directory (for example C:\Documents and Settings\USER\My Documents)
  6. Put . for files which are not copied but may be generated by application and need to uninstall
  7. Put > for executable file which must be executed after installation is finished (this file must also be listed under + or - and it must exist in Target directory. You may also open non executable file in the same way (for example text file)
  8. Put ! for files which must be deleted from old version before installing new one
  9. Put \. for a directory which must be created on target directory
  10. Put \* for a directory which must be created on user My documents directory
  11. 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 sub directory of the current user My documents directory (example: tag \*LEGAL, see below example Output list). To copy a file to that directory use notation  *LEGAL\LICENCE.TXT. Keep in mind that other users of this computer might not be able to access those files!
  3. 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 CD-ROMs or 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 kByte (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 disks. 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). All files are put in respective directories (disk1, 2,..) so no sub-directories are created.

5. Other options set through SETDATA editor:

 

REMARKS AND LIMITATIONS

 

SAMPLE FILES

- sample SETDATA :

[main]
ApplicName=Ssetup Dummy
Head_Text=Ssetup - Setup design for win95/ 98/ 2000/ XP/ Vista
Def_Group=Ssetup Dummy Group
Def_Path=<program files>\Ssetup
Ver=5.10.0
Producer=Davor Zorc
Homepage=http://www.fsb.hr/~dzorc/ssetup.html
Form_Color=$00FFA6A6
UninstallOldVer=0
Ask_Overwrite=0
Ask_Dir_Overwrite=0
Run_Program=0
Ask_Licence=0
FullScreen=1
WelcomePanel=0
Check_DiskFree=0
SpaceNeed=559
UseRegRunOnce=0
Source_Size=0
UninstallReport=1
AskDeleteShared=0 

- 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, * = copy user dir.
; . = no copy, ! = delete, > = run, \ = mkDir,
;
;------------- 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       ;copy & make icon
+DUMMY.EXE,Dummy Application^    ;copy & make desktop icon: "Dummy Application"
>DUMMY.EXE        ;run this after installation (must also be after +)
-DUMMY.RES        ;copy only
~DUMMY.DLL        ;copy to windows system dir
=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 relative to target drive root
*SSETUP_LEGAL\LICENCE.TXT ;copy to this user "My documents" directory
;
;------------- make Directories ----------------------------------------------
;
\.DOC             ;create extra sub-directory in Target directory
\\DATA\PIPI       ;create absolute directory on Target drive
\*SSETUP_LEGAL    ;create directory on this user "My documents" directory
;-----------------------------------------------------------------------------
 

 

INSTALLATION (GUIDE FOR END USERS)

NOTES:

 

UNINSTALL (GUIDE FOR END USERS)

 

REGISTRATION

This program is unregistered PERSONAL FREEWARE but requires payment to the author for commercial use. It is the full feature version and free to test for one month. It is illegal to use this program in your commercial 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)

Comments and suggestions are welcome! I would enjoy receiving picture postcards from users around the world. Thanks!
 

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

UPGRADE PRICE FOR SINGLE COMMERCIAL USE: 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/, in section:
 >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, its look and feel and its functionality is Copyright (c) by Davor Zorc.

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

This program is PERSONAL FREEWARE and requires payment to the author for commercial use, after 30 days of trial period. 

Mentioned hardware and software products are (c) of their own producers.

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

 

ACKNOWLEDGEMENTS

- ZIP.EXE is a product of Info-ZIP (here renamed to SSZIP32.EXE). See licence by Info-ZIP)
- Self-Extracting EXE module sfx_tuni.stb is based on David Cornish's SFX Maker ver. 2.5 SR-2b
- Logo image, full credits to Vasili Vorotnikov, www.vaksa.net
- Many thanks to my friend 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
  •