home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / sfx.zip / SFXSetup.hlp (.txt) < prev   
OS/2 Help File  |  2000-01-13  |  35KB  |  759 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. SFX Installer ΓòÉΓòÉΓòÉ
  3.  
  4. The SFX Installer is made up of two parts. The setup tool [SFXSetup.exe] and 
  5. the actual Installer which is put together when the setup is complete. 
  6.  
  7. The setup tool will help you easily put your package together by letting you 
  8. select items and fill in the blanks. This saves you the trouble of cryptic 
  9. commands or scripts that need to be filled out. The toughest part will be 
  10. getting your setup strings together (for desktop objects) but most of you 
  11. should be familiar with that. 
  12.  
  13. The SFXSetup tool will allow you to: 
  14.  
  15.      Select files to archive 
  16.      Set the archive name 
  17.      Set the destination directory 
  18.      Toggle - use installer 
  19.      Toggle - make self-extracting 
  20.      Select a bitmap for the splash screen 
  21.      Setup unlimited object strings 
  22.      Customize the color scheme 
  23.      Personalize the installer with your program name 
  24.      Set special commands by way of plugins 
  25.      Set readme or license files to show the end user 
  26.      Toggle dll & help path windows 
  27.      Save or reload your archive setup information 
  28.  
  29.  The installer is based on the same installer used for WarpZip. It leads your 
  30.  user through the installation page by page. It installs your app and if you 
  31.  have used the SFX option will clean up back to it's original file. It will: 
  32.  
  33.      Slide your bitmap into the splash screen 
  34.      Personalize a few spots in the text 
  35.      Allow users to set the installation directory 
  36.      Create the installation directory if needed 
  37.      Allow users to select an existing dll directory or modify the LIBPATH 
  38.      Allow users to select an existing help directory or modify SET HELP 
  39.      Backup config.sys if needed 
  40.      Skip dll & help pages if you don't need them 
  41.      Create unlimited objects 
  42.      Write a log file of the install 
  43.      Write an Uninstall script specific to the installation 
  44.      Show your License or readme 
  45.      Run your plugin (Rexx .cmd file) at installation time 
  46.  
  47.  It will not: 
  48.  
  49.      Create directories more than one deep 
  50.      Package archives with subdirectories 
  51.  
  52.  Here are some other Notes and tips 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 2. Notebook pages ΓòÉΓòÉΓòÉ
  56.  
  57. Notebook pages 
  58.  
  59. A blow by blow description of each page. [terse] 
  60.  
  61.      Directory container 
  62.      Program files 
  63.      Archive name 
  64.      Install settings 
  65.      Objects 
  66.      Colors 
  67.      Plugins 
  68.      Finish 
  69.      Zip Location 
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 2.1. Directory container ΓòÉΓòÉΓòÉ
  73.  
  74. Directory container 
  75.  
  76. The directory container attempts to show every available drive and is used in 
  77. two different ways depending on what window is open in the notebook. 
  78.  
  79.      When the  Program files page is showing, selecting directories aids in 
  80.       locating the files you want to add to your archived package. Each time a 
  81.       directory is chosen, the listbox on the "Program files" page is updated 
  82.       with the contents of that directory. 
  83.  
  84.      When the  Archive name page is open, you can use the directory container 
  85.       to aid in choosing your directory for the "Archive location" entry field. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 2.2. Program files ΓòÉΓòÉΓòÉ
  89.  
  90. The Program files page 
  91.  
  92. The Program files page shows a listbox and three radio buttons. Here you will 
  93. choose what files to add to your archived distribution. When you select a 
  94. directory from the directory container on the left side, the files contained in 
  95. that directory are automatically listed in the listbox on this page. 
  96.  
  97. The "Directory" radio button is automatically highlighted when you start. If 
  98. you select a file in the listbox the "Selected files" radio button will be 
  99. automatically highlighted and only the selected files will be added to your 
  100. archive. Be sure to check if this is the setting you want before leaving this 
  101. page. 
  102.  
  103. It is also possible to delete files from the directory by highlighting the 
  104. files you want removed and hitting the [DELETE] key on your keyboard. This may 
  105. be desirable when you have changed the bitmap you will be using or wish to drop 
  106. some files from the distribution and still want to archive by "Directory". 
  107. Again, check to see if the correct radio button is selected for the type of 
  108. file listing you want to archive before leaving this page. 
  109.  
  110. Note: Building your archive with the "Directory" choice is much faster than 
  111. doing it by "Selected files" because of the way it is processed by zip.exe but 
  112. the progress indicator will not be incremented as well for the same reason. 
  113.  
  114.  
  115. ΓòÉΓòÉΓòÉ 2.3. Archive name ΓòÉΓòÉΓòÉ
  116.  
  117. The Archive name page 
  118.  
  119. The Archive name page consists of two entry fields for your archive's new name 
  120. and location. 
  121.  
  122.      Archive name - This is the actual name you want for the zip file or 
  123.       self-extracting exe if you use that option. The name will be 
  124.       automatically adjusted (zip or exe) depending on selections made 
  125.       elsewhere in the program. 
  126.  
  127.       Warning: Previously you could not use the same name as a file in your 
  128.       archive may have. For example, if your widget program was called 
  129.       "Widget.exe" you could not use "Widget.exe" for the archive name. We have 
  130.       added an automatic renaming scheme but it still needs a thorough testing. 
  131.       Please be sure it is working properly before sending your archive out.
  132.  
  133.      Archive location - This is where you want the archive to reside when it 
  134.       is built. You can use the directory container to aid in choosing your 
  135.       directory. 
  136.  
  137.  Because of the nature of this program, older archives in are overwritten by 
  138.  default. If you wish to save an old archive you must move or rename it or it 
  139.  will be lost. This shouldn't be an issue for most as it is much less of a pain 
  140.  to save one once in a while rather than always having to confirm an overwrite. 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ 2.4. Install settings ΓòÉΓòÉΓòÉ
  144.  
  145. The Install settings page 
  146.  
  147. The Install settings page has these choices: 
  148.  
  149.      Program name the installer should use - Enter the name you want the 
  150.       installer to use to identify your program in the text fields during the 
  151.       installation. Be sure to test run the installer and check the locations 
  152.       your name is used to be sure the context is correct for the name. Usually 
  153.       a simple title will work best. A long name will push other text out of 
  154.       their allotted space. Don't, for example use a name like, "Joe's Black 
  155.       Book version 3.1 revision 2". Keep it short and check the context. 
  156.  
  157.      Suggested directory name the installer should use - This will be the 
  158.       initial directory shown in the directory field of the installer. Your 
  159.       suggested name will be appended to the root of the boot drive's name. 
  160.       Example: Your suggested name is "Widget" and the users boot drive is "C". 
  161.       The installer will list "C:\Widget" as the suggested directory. The user 
  162.       may, and most likely will, change it to a location that they prefer. 
  163.  
  164.      Bitmap to use for the splash screen - Enter the bitmap name here or click 
  165.       the "Browse" button to locate it. This field must have the fully 
  166.       qualified name of the bitmap. Your bitmap must also be an OS/2 .BMP file. 
  167.       Best results will be with bitmaps measuring 335x200 (pixels) or less. 
  168.       (from my tests this size allows it to fully display on a 640x480 
  169.       resolution system. Experiment with this until you've found what you want. 
  170.       If this field is left empty the installer will show a generic "SFX 
  171.       Installer" bitmap. Large bitmaps can be used to good effect too but the 
  172.       weight they carry in filesize is usually to much to bear. 
  173.  
  174.      Use dll page - If this checkbox is selected, the installer will use the 
  175.       dll page that gives a listing of current LIBPATH entries. If the user 
  176.       chooses to place your dlls in one of the listed directories it will avert 
  177.       the need to modify the LIBPATH statement in the config.sys. If you don't 
  178.       need to place your dlls in the LIBPATH you may leave this unchecked and 
  179.       they will be handled just like your other files. 
  180.  
  181.      Use help page - If this checkbox is selected, the installer will use the 
  182.       help page that gives a listing of current SET HELP entries. If the user 
  183.       chooses to place your help file in one of the listed directories it will 
  184.       avert the need to modify the SET HELP statement in the config.sys. If you 
  185.       don't need to place your help file in the SET HELP path you may leave 
  186.       this unchecked and it will be handled just like your other files. 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ 2.5. Objects ΓòÉΓòÉΓòÉ
  190.  
  191. The Objects page 
  192.  
  193. Add any setup strings for objects you need to create in this field. These are 
  194. Rexx "SysCreateObject" calls and you can add as many as you want as long as 
  195. they are on separate lines. The variable "InstDir" can be used in your setup 
  196. string to denote the installation directory name without the trailing slash. 
  197.  
  198.      First line - one setup string (a folder maybe) 
  199.      Second line - another string (your program object/icon) 
  200.      Third line - another string (your readme.1st object/icon) 
  201.      and so on... 
  202.      and so on... 
  203.  
  204.  I'm sure most of you are familiar with them but... just in case... Example 
  205.  setup strings are included and loaded when the program is started and will 
  206.  continue to load at startup until such time that new default settings are 
  207.  saved. When you save default settings you will be saving any setup strings in 
  208.  the entry field over the top of the old ones. If the original strings are in 
  209.  the entry field they will be saved otherwise your changed strings will become 
  210.  the defaults loaded at startup. 
  211.  
  212.  In order for the uninstall script to work, all of your creations will need an 
  213.  OBJECTID included in the setup string. The setup tool will warn you if an 
  214.  OBJECTID is missing but will still build the archive. The three example 
  215.  strings included at program start show how to create a folder and two program 
  216.  objects. Feel free to modify the examples to fit your installation 
  217.  requirements. Remember to do them in the proper order. You'll need to create 
  218.  the folder (if you need one) before you can place program objects in it. 
  219.  
  220.  A one line string isn't as pretty as a nicely formatted one in a cmd file but 
  221.  it will work this way. The installer doesn't know what your strings are but 
  222.  can execute them if they are formatted properly. Take a look at the examples, 
  223.  the ini.rc file in your \os2 directory or the OS/2 Procedures Language 2/Rexx 
  224.  for some further insight into setup strings. 
  225.  
  226.  Remember:  Choose OBJECTID's carefully. Do not use the same ones anyone else 
  227.  may use. This will only cause trouble between applications. Your OBJECTID's 
  228.  should be something no one else will use so be sure to choose wisely. Also, be 
  229.  sure to change or delete the examples before you build an archive. You won't 
  230.  want any of them to go with your application. 
  231.  
  232.  
  233. ΓòÉΓòÉΓòÉ 2.6. Color Scheme ΓòÉΓòÉΓòÉ
  234.  
  235. The Color Scheme Page 
  236.  
  237.      The Color Scheme page has three buttons on it. Pressing either of the top 
  238.       two will open a mockup of either your install.exe splash screen or one 
  239.       representing the rest of the pages. It will also open the OS/2 color 
  240.       palette so you can drag any color selections to the mockup to customize 
  241.       your color scheme. 
  242.  
  243.      A simple drag and drop from the palette will change the background color. 
  244.  
  245.      Holding the <control> key down while dropping a color will change the 
  246.       foreground color. (text color) 
  247.  
  248.      If you make no changes the installer will use it's own defaults or 
  249.  
  250.      If you've made changes and wish to return to the program defaults just 
  251.       press the "Return to default scheme" button. 
  252.  
  253.      If you have selected a bitmap to use on the  Install settings page, it 
  254.       will be used in the mockup. 
  255.  
  256.      Pressing the "Next" button on the Splash screen mockup or the "Back" 
  257.       button on the "Pages" mockup will open the other window for color 
  258.       editing. 
  259.  Check the Tips page setting background color when using large bitmaps. 
  260.  
  261.  
  262. ΓòÉΓòÉΓòÉ 2.7. Plugins ΓòÉΓòÉΓòÉ
  263.  
  264. The Plugins Page 
  265.  
  266. The plugin page allows you to select files from your archive that will do two 
  267. things. You can: 
  268.  
  269.      Write a cmd file that can be processed while the install program is 
  270.       running. 
  271.      Have the installer show a text file (maybe a readme.txt or a license) to 
  272.       the user. 
  273.  
  274.  If it is important for you to display your license agreement before 
  275.  installation be sure to use the word "License" in the name of the file. If the 
  276.  installer loads any file with "License" in it's name it will show an "Accept" 
  277.  or "Do not accept" button. The installer will automatically close and clean up 
  278.  if the "Do not accept" button is pressed. I am not sure of all the legalities 
  279.  but would think that this would confirm the entrance of a contract between you 
  280.  and your user since he cannot use the software without going around the 
  281.  installation. 
  282.  
  283.  Any other file (a readme.txt etc) will be loaded normally when using the text 
  284.  window and will only show a "Close" button. 
  285.  
  286.  Plugin selection 
  287.  
  288.  The listbox carries the file listing that you are using for the archive. To 
  289.  select a file and assign it for the installer you need to: 
  290.  
  291.      Highlight the file you wish to use/display 
  292.      Click the button that refers to how you want it used 
  293.  
  294.  After clicking the button, the filename will appear above the button that 
  295.  refers to it. 
  296.  
  297.  To make it a bit more flexible, you can choose whether to have it process 
  298.  these files at the start of the installation or at the end. The "PRE" type 
  299.  files will always show or run immediately after your bitmap has finished 
  300.  sliding onto the splash page. The "POST" type files will run after all the 
  301.  installer processing has finished and the program is ready to close and clean 
  302.  up. 
  303.  
  304.  While the possibilities and usage of the text files will be obvious to most of 
  305.  you, the cmd files may need a bit more explanation. Suffice it to say that it 
  306.  lends you as much power during the installation as Rexx provides in OS/2 and 
  307.  that is darn near limitless. You might, for example want to: 
  308.  
  309.      Create directories 
  310.      Jockey files around 
  311.      Add information to the os2.ini file 
  312.      Make adjustments to your program ini files 
  313.      Get system information 
  314.      Show the user a messagebox with info 
  315.  
  316.  You decide what you want to do and the installer will execute it. The sample 
  317.  supplied with this program shows a simple messagebox just to show you how and 
  318.  at what time in the installation it works. You will probably not want to be so 
  319.  intrusive with your plugins. You can (and probably "should") have them run 
  320.  without the user even realizing that it is even there. 
  321.  
  322.  Like the setup strings, the variable "InstDir" is available to be used in your 
  323.  plugin to help find the installation directory for any work you may need to 
  324.  do. The "InstDir" variable is always without the trailing slash. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 2.8. Finish ΓòÉΓòÉΓòÉ
  328.  
  329. The Finish page 
  330.  
  331. The Finish page has three radio buttons, a "Build" button and a process 
  332. indicator. The radio buttons help select the type of archive you wish to build 
  333. and the "Build" button will begin the process of gathering all of your 
  334. information and building the archive accordingly. 
  335.  
  336. Here are the choices: 
  337.  
  338.      Standard zip no installer - Will build a common "zip" archive with a 
  339.       "zip" extension. All self-extractor and installer options are ignored. 
  340.  
  341.      Standard zip with installer - Will build a common "zip" archive with a 
  342.       "zip" extension. The installation program is configured and placed in the 
  343.       zip archive. The installation program does not start automatically. 
  344.  
  345.      Self extractor no installer - Will build a self extracting "zip" archive 
  346.       with an "exe" extension. This will build your archive in the common 
  347.       self-extracting zip format but will not add the installer to the archive. 
  348.  
  349.      Self extractor with installer - Will build a self extracting "zip" 
  350.       archive with an "exe" extension that will automatically run the installer 
  351.       when it is executed. All files that were extracted from your archive will 
  352.       be removed by the installer once the installation is finished. 
  353.  
  354.  Once you have made your selections and are satisfied that it is as you like it 
  355.  you may press the "Build" button and let it work. The text over the progress 
  356.  indicator will keep you abreast of what is happening and there will be a small 
  357.  beep when the build is completed. 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 2.9. Zip Location ΓòÉΓòÉΓòÉ
  361.  
  362. The Zip Location page 
  363.  
  364. The Zip Location page has two entry fields for the locations of InfoZip's 
  365. zip.exe and unzipsfx.exe. SFX tries to locate them on startup so they may 
  366. already be entered for you but if they are not, you'll need to "browse" for 
  367. them. 
  368.  
  369. Be sure you are using version 2.2 of the InfoZip "Zip" utilities. If the 
  370. version that is found or the one you browse for is not version 2.2, the entry 
  371. field will remain blank and you will not be able to use the setup tool to build 
  372. archives. The reason it needs to be 2.2 has to do with the way the archives are 
  373. adjusted when they are built. 
  374.  
  375.  
  376. ΓòÉΓòÉΓòÉ 3. Menu items ΓòÉΓòÉΓòÉ
  377.  
  378. Menu items 
  379.  
  380. Here are a few short menu item explanations that are not part of the obvious 
  381. ones every program has. 
  382.  
  383.      Load archive setup 
  384.      Save archive setup 
  385.      Save default setup 
  386.  
  387.  
  388. ΓòÉΓòÉΓòÉ 3.1. Load archive setup ΓòÉΓòÉΓòÉ
  389.  
  390. Load archive setup 
  391.  
  392. When using "Load archive setup" a dialog will open with an entry field, a 
  393. combobox and two buttons. To select a setup to load you will open the combobox, 
  394. make a selection and click the "Open" button. 
  395.  
  396. All information from the chosen setup will be imported to the program and 
  397. should, at that time, be set up just as you had it configured when you saved 
  398. the setup. 
  399.  
  400. Please check the individual pages for accuracy before building from the 
  401. configuration. There may have been changes in your directories etc. since you 
  402. saved the setup that will make some entries invalid. 
  403.  
  404.  
  405. ΓòÉΓòÉΓòÉ 3.2. Save archive setup ΓòÉΓòÉΓòÉ
  406.  
  407. Save archive setup 
  408.  
  409. When using "Save archive setup" a dialog will open with an entry field, a 
  410. combobox and two buttons. Enter the name you wish to save the setup under or 
  411. select an existing setup from the combobox. To select an existing setup from 
  412. the combobox, you will open the combobox and click on the name you are looking 
  413. for to make the selection. 
  414.  
  415. After the name is entered or the selection has been made you may click the 
  416. "Save" button to have the program process and save all of the setup 
  417. information. 
  418.  
  419. Please check the individual pages for accuracy before saving any configuration. 
  420.  
  421.  
  422. ΓòÉΓòÉΓòÉ 3.3. Save default setup ΓòÉΓòÉΓòÉ
  423.  
  424. Save default setup 
  425.  
  426. When using "Save default setup" the program will process and save all of the 
  427. setup information that is currently loaded. After saving a default setup, the 
  428. program will always load it at each startup. 
  429.  
  430. This is handy if you want a certain set of colors, setupstrings, a certain 
  431. build directory etc to be loaded and ready to go every time without having to 
  432. set them manually. 
  433.  
  434.  
  435. ΓòÉΓòÉΓòÉ 4. Notes and tips ΓòÉΓòÉΓòÉ
  436.  
  437. Notes and tips 
  438.  
  439. I never was very good at taking notes... 
  440.  
  441.      General Installer Notes 
  442.      SFX Installer Notes 
  443.      SFX UnInstaller Notes 
  444.      Tips 
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ 4.1. General Installer Notes ΓòÉΓòÉΓòÉ
  448.  
  449. General Installer Notes 
  450.  
  451.      Try to keep your bitmaps as small as possible. The OS/2 BMP format is not 
  452.       known for it's compression. Try indexing your bitmap to 256 colors and 
  453.       use RLE/Huffman encoding to save some space. I have seen some bitmaps 
  454.       that do not seem to want to work using RLE/Huffman encoding though. YMMV 
  455.  
  456.      By default the installer will scroll your bitmap to the center of the 
  457.       form and vertically centered just above the centerline. You can offset 
  458.       your image with white space if you want your bitmap to appear left of 
  459.       center for example. (to balance it out with the buttons) So you might 
  460.       draw a 200x100 bitmap all the way to the left inside a 300x100 bitmap 
  461.       that is all white. The installer will see it as a 300x100 and scroll it 
  462.       to the center, the extra white space on the right doesn't show up on the 
  463.       white background and your offset part of it will appear left of center. 
  464.       If you're wondering what is meant by all of this, you can see an example 
  465.       by dropping some color on the splash screen of the sfx.exe archive this 
  466.       program came in. 
  467.  
  468.      Although a 450 pixel wide bitmap will fill the splash page in 1024x768 
  469.       resolution, try to keep your bitmaps less than 335 pixels wide and 200 
  470.       pixels high. This will allow the full bitmap to fit on the splash screen 
  471.       for the people using a lower resolution like 640x480.  It is possible to 
  472.       use larger bitmaps to fill the background on all resolutions with good 
  473.       effects by keeping the important parts of it on the middle 335x200 area 
  474.       and if the file size doesn't become to much to bear. Note: If you want to 
  475.       avoid the buttons with your bitmaps when the user is in 640x480 
  476.       resolution you may want to stay under 183 pixels high. 
  477.  
  478.      Large bitmaps can be used to show a fancier background if you care to 
  479.       attempt it. Try to keep your title information in the middle 335x200 area 
  480.       of the bitmap or it may not appear properly on low resolutions. We have 
  481.       tried a 500x350 bitmap that seems to give a nice effect this way. 
  482.  
  483.      The bitmap may smear across the screen for some users. Most video cards 
  484.       shouldn't do this but it has been noticed happening sporadically on an 
  485.       older machine with an old cirrus card in it. If anything else was going 
  486.       on it would smear. I guess that's the price we pay for all this glitz. 
  487.       <BG> 
  488.  
  489.  
  490. ΓòÉΓòÉΓòÉ 4.2. SFX Installer Notes ΓòÉΓòÉΓòÉ
  491.  
  492. SFX Installer Notes 
  493.  
  494.      After an SFX installation, the installer will always delete all the files 
  495.       it has unarchived while leaving any files that were pre-existing intact. 
  496.  
  497.      Because of the nature of the self-extracting installer and it's clean up 
  498.       of temporary files, the user will not be allowed to install into a 
  499.       directory that the installer is started from. There will be a message to 
  500.       that effect if the situation arises but it might be something that you 
  501.       mention in your readme. 
  502.  
  503.      The SFX Installer will check free space on the current hard drive when it 
  504.       is about to unarchive and if it is marginal will ask for a new drive to 
  505.       place temporary files in. It will keep asking if the followup drives are 
  506.       marginal also. You can force it to try anyways by using the F parameter. 
  507.       We are considering whether to find space automatically instead of asking 
  508.       which drive to use but a decision has not been made relating to that yet. 
  509.  
  510.      Previously you could not use the same name on an SFX Installer archive as 
  511.       a file inside your archive may have had. For example, if your widget 
  512.       program was called "Widget.exe" you could not use "Widget.exe" for the 
  513.       archive name. We have added an automatic renaming scheme but it needs a 
  514.       thorough workout to be sure it is mistake free so please make sure your 
  515.       archive works properly before you send it out. 
  516.  
  517.  There are some reserved names that are not allowed as they will conflict with 
  518.  names used by the installer. That should not be a problem for the most part 
  519.  though. They are: 
  520.  
  521.      Install.exe 
  522.      Install.dat 
  523.      Install.log 
  524.      UnInstal.cmd 
  525.  
  526.  These files are deleted (if they already exist) and are rewritten each time an 
  527.  archive is built or when it is installed depending on the files usage. 
  528.  
  529.  
  530. ΓòÉΓòÉΓòÉ 4.3. SFX UnInstaller Notes ΓòÉΓòÉΓòÉ
  531.  
  532. SFX UnInstaller Notes 
  533.  
  534.      All we are actually doing for an uninstaller is writing a rexx script 
  535.       (and it is pretty simple) when the installation is finished but just 
  536.       before the program closes. It is written using information from the users 
  537.       installation choices so if they put dll's in c:\bin\dll for example, we 
  538.       add a line in the script for every dll that is put there. Using a rexx 
  539.       script also means that after deleting all the files and destroying any 
  540.       objects that the installer created, it can back out of the directory and 
  541.       delete it too leaving no trace of the installation... with some minor 
  542.       exceptions... 
  543.  
  544.         -  Nothing is added to remove info from the config.sys if the user had 
  545.            the installer change it. There is just a message for the user to do 
  546.            that manually. 
  547.         -  It doesn't account for any subdirectories that may have been 
  548.            created. 
  549.         -  It doesn't account for deleting read only files. 
  550.  
  551.      Some of the script writing is conditional... IF there were dll's written 
  552.       to another directory THEN add warnings about deleting them etc. We could 
  553.       add the config.sys info removal also but because it is put together 
  554.       dynamically, without our actual reviewing of it when it is finished, we 
  555.       need to be sure it works EVERY time with NO mistakes before we add 
  556.       something of that nature. 
  557.  
  558.  The UnInstall script is actually pretty simple and is always customized to the 
  559.  specific installation. You can see exactly what it is by taking a peek at the 
  560.  script after you install a program using it. 
  561.  
  562.  It is also possible for you to modify the uninstall script also via a plugin 
  563.  if you need to. Let's suppose that you have written a plugin to do some extra 
  564.  work. You might: 
  565.  
  566.      Create another directory under the program directory 
  567.      Unzip a zipfile that was installed with the program into the new 
  568.       directory 
  569.      Delete the zipfile 
  570.      Find the line with the zipfile name in the uninstal.cmd file and remove 
  571.       it 
  572.      Add lines to the uninstal.cmd file to delete the files you just 
  573.       unarchived 
  574.      Add a line to the uninstal.cmd file to remove the directory you just made 
  575.  
  576.  These may be great lengths to go to but they will help overcome the 
  577.  limitations of what this installer can do for you. 
  578.  
  579.  The uninstall script also makes the user confirm that any dll's are looked 
  580.  over first if there were dll's installed outside of the program directory. It 
  581.  will not run until the user reads the warnings and affirms the deletion. 
  582.  
  583.  
  584. ΓòÉΓòÉΓòÉ 4.4. Tips ΓòÉΓòÉΓòÉ
  585.  
  586. Tips 
  587.  
  588.      If your bitmap covers all of the splash screen mockup when you are 
  589.       dropping a background color onto it, the dropped color will not be seen 
  590.       by the background at all. To be able to do this you will need to: 
  591.  
  592.         -  Go back to the "Install settings" page 
  593.         -  Select and copy the bitmap name into the clipboard 
  594.         -  Delete the bitmap name from the entry field 
  595.         -  Return to the "Color schemes" page and set your background color 
  596.         -  Paste the bitmap name back into the entry field on the "Install 
  597.            settings" page 
  598.  
  599.  
  600. ΓòÉΓòÉΓòÉ 5. Distributing your application ΓòÉΓòÉΓòÉ
  601.  
  602. Distributing your application 
  603.  
  604. Warning At this time there is a problem with self-extracting installations done 
  605. on Warp4 machines with fixpack 10 and Object Rexx installed. Apparently there 
  606. are some issues that need to be resolved so you need to be aware of the 
  607. situation and possibly make a "standard zip with installer" available to those 
  608. who fit into this catagory. 
  609.  
  610. Please do not distribute archives built with this beta until it is pronounced 
  611. ready. Besides your License agreement, there still may be things we need to 
  612. make adjustments to that will save both you and I some trouble. If anyone tries 
  613. your archive before the installer is fully tested and encounters a problem they 
  614. will be giving you a call wondering why it doesn't work and you, myself and the 
  615. installer will look bad in their eyes. 
  616.  
  617. The Hobbes FTP site allows "zip" files only to be placed on their site. That 
  618. means most of you will archive using the "Standard zip with installer" option 
  619. when building your archives. Using "Self-extractor with installer" will be 
  620. something you may want to do for archives that are downloaded from your own 
  621. website or distributed on disk or CD depending on the distribution method or 
  622. the distributor. 
  623.  
  624. Normally Hobbes will only allow archivers and some compressed media files to be 
  625. uploaded in anything other than a zip file. The rest of the archives must be in 
  626. "Zip" format. When we release this program for example, it will probably be in 
  627. a zip file. 
  628.  
  629. If you have a special situation that you want or need it for right away, please 
  630. ask and we will let you know where we stand. Otherwise, we will let you know as 
  631. soon as it is ready for public usage. 
  632.  
  633.  
  634. ΓòÉΓòÉΓòÉ 6. License ΓòÉΓòÉΓòÉ
  635.  
  636. Licensing 
  637.  
  638. The license agreement may sound a bit different than a standard one might as 
  639. we'd like to help any freeware authors if we can because of all the unselfish 
  640. things they have done and are doing for OS/2. It seems to us that this is a 
  641. fair and just way of doing that and yet still staying on level ground with a 
  642. commercial or shareware developer. 
  643.  
  644. For purposes of this License agreement the following terms shall apply. 
  645.  
  646. Commercial software - Software distributed through retail outlets, commercial 
  647. vendors, commercial catalog sales. "Boxed" software is generally considered 
  648. commercial. 
  649.  
  650. Shareware - Software not falling under the category of Commercial software that 
  651. is distributed with a suggested, expected or required value that is paid for 
  652. it's use. Shareware is considered electronically distributed with allowances 
  653. made for distribution on disk or CD when required by the user or distributed on 
  654. a publicly recognized and publicly available collection of shareware. Shareware 
  655. does not include software that is "packaged in and packaged for" a commercial 
  656. or government environment. 
  657.  
  658. Freeware - Software distributed at no cost to the end user. No renumeration is 
  659. asked for, no renumeration is expected and no donations are suggested for it's 
  660. use. Freeware does not include software that is "packaged in and packaged for" 
  661. a commercial or government environment. Software generally considered to be 
  662. "Postcardware" or "Emailware" will fall under this category. 
  663.  
  664. Program status - The determination of whether a program is in the Commercial, 
  665. Shareware or Freeware categories. 
  666.  
  667. Developer - The author, developer, publisher or authorized agent for the 
  668. program in question. 
  669.  
  670. License Agreement 
  671.  
  672.      The SFX Installer is not free. It is a publicly marketed program that 
  673.       allows any user to freely test and decide if it fits their needs before 
  674.       they make a purchase decision. PillarSoft also offers this program to 
  675.       FreeWare authors under strict guidelines for their personal use at no 
  676.       cost and at the pleasure of PillarSoft. 
  677.  
  678.      Freeware authors may seek a license from PillarSoft for the use of SFX, 
  679.       the distribution of archives packaged with SFX and distribution of 
  680.       self-extracting installers built with SFX at no cost when their product 
  681.       qualifies as a product that is distributed as Freeware and until such 
  682.       time that the program has a monetary value attached to it's usage. 
  683.  
  684.      For FreeWare licensees, the license will be rendered null and void upon 
  685.       the first distribution of a package that calls for a registration fee, 
  686.       donation or any other form of financial renumeration. 
  687.  
  688.      No archive or self-extracting archive packaged with, or from parts of, 
  689.       the SFX Installer and it's packaged contents may be used to distribute or 
  690.       package software or data for profit without prior licensing and the 
  691.       expressed written consent of PillarSoft. 
  692.  
  693.      The SFX Installer may not be used by any commercial or governmental 
  694.       agency without prior licensing and expressed written consent of 
  695.       PillarSoft. 
  696.  
  697.      The copyright notice (or banner) on the splash page must remain plainly 
  698.       visible at all times. (It is is not presently configurable) 
  699.  
  700.      The SFX Installer may not be used or distributed as part of any other 
  701.       program other than to perform the archiving or assist in the installation 
  702.       of said program as was intended by PillarSoft. 
  703.  
  704.      PillarSoft reserves the right to withdraw this program, the use of the 
  705.       program or a particular license for this program at any time and at the 
  706.       disgression of PillarSoft. 
  707.  
  708.      Determination of program status for the purposes of this license will be 
  709.       at the sole disgression of Pillarsoft. 
  710.  
  711.      Disagreements concerning PillarSoft's determination of the program status 
  712.       and the status represented by it's developer automatically void the 
  713.       program license. 
  714.  
  715.      Site licensing will be determined on a case by case basis. 
  716.  
  717.      Do not bend, fold or mutilate. 
  718.  
  719.      Objects may be closer than they appear. 
  720.  
  721.  The long and short of it... 
  722.  
  723.  The reason the license agreement gets a bit detailed is to prevent someone 
  724.  (there's always a rotten apple) from obtaining a license for his (or her) 
  725.  program claiming it is freeware or dirt cheap just to get a free or an 
  726.  unrealistically cheap license and then decide that it is worth $30 when it is 
  727.  actually released. This may seem like no big deal to most but personally, I 
  728.  have a hard time being nice to people that try to take advantage of others. 
  729.  I'd rather spell everything out ahead of time and avoid any problems in the 
  730.  future. 
  731.  
  732.  We would like to be as helpful as possible to freeware authors. There are 
  733.  people that give so much to the OS/2 community in the way of free software 
  734.  (some of it is Great software) and never ask for anything in return. In some 
  735.  small way, PillarSoft would like to say "Thanks" and to see them receive the 
  736.  same treatment they have given to everyone else. 
  737.  
  738.  For Shareware authors may contact BMT Micro for licensing. Commercial and 
  739.  governmental agencies may contact us directly at: support@pillarsoft.net 
  740.  
  741.  We can be found on the web at: http://www.pillarsoft.net 
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ 7. InfoZip ΓòÉΓòÉΓòÉ
  745.  
  746. InfoZip 
  747.  
  748. The SFX Installer incorporates compression code from the Info-ZIP group into 
  749. your archive. There are no extra charges or costs due to the use of this code, 
  750. and the original compression sources are freely available from 
  751. http://www.cdrom.com/pub/infozip/ or ftp://ftp.cdrom.com/pub/infozip/ on the 
  752. Internet. 
  753.  
  754. SFX searches for Infozip's "Zip.exe" and "Unzipsfx.exe" upon program startup on 
  755. new installations and are version checked for version 2.2. If you wish to 
  756. relocate them you will need to update the "Zip location" notebook page with 
  757. their new path in order to build any archives. 
  758.  
  759.