Ssetup32 ver. 4.50, (c) by Davor Zorc, Zagreb, Croatia, 2003.

  • 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

    INSTALLATION (GUIDE FOR END USERS)

    NOTES:

    UNINSTALL (GUIDE FOR END USERS)

    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  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 file list. Click on menu Edit/ Edit logo to edit logo picture visible on the main window.

     

    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:

    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:

    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
    Rgb_Color=r192g192b192
    Ask_Overwrite=0
    Run_Program=0
    Ask_Licence=0
    Check_DiskFree=0
    Source_Size=0
    SpaceNeed=155
    UseRegRunOnce=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,
    ; . = 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 registrer 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 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
    ___________________________________________________________________
    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:

    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