home *** CD-ROM | disk | FTP | other *** search
/ Chip 1996 December / CHIP_CD_1996_12_PL.iso / sharewar / shtools / instexpr / notes.txt < prev    next >
Encoding:
Text File  |  1996-02-25  |  7.6 KB  |  194 lines
  1. DISCLAIMER
  2. ----------
  3. I wrote this software mainly for myself, and it works for me.
  4. It may not work for you, though. If it breaks your data, PC, reputation
  5. or anything else you have my condolences. But you don't get a guarantee,
  6. so I can't acceept any responsibility. Sorry....
  7.  
  8. This software is distributed as FREEWARE which means that you can copy
  9. it as much as you like, and you don't have to give me any money.
  10. But you can't modify it and you must include this text file with any copies.
  11.  
  12. This software is copyright (c)1995, 1996 Marc Evans.
  13.  
  14. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  15.  
  16. Installation Expert (v1.0):
  17.  
  18. Installation (of the installation expert!)
  19. -------------
  20.  
  21. 1) Unzip the package. (You must have done that to be reading this...)
  22. 2) Make sure that delphi is NOT running.
  23. 3) Run the SETUP.EXE program from wherever you unzipped it to.
  24. 4) Run delphi.
  25.  
  26. This will copy the necessary files into the specified directory. It will
  27. also modify DELPH.INI in the windows directory to include a line that will
  28. load the install expert, and create a file LEVINST.INI in the windows
  29. directory.
  30.  
  31. The newly created LEVINST.INI file in the windows directory will need the
  32. TempDir item pointing to a directory that can be used for temporary
  33. files. This MUST point to a valid, existing directory, otherwise the 
  34. expert will not work.
  35.  
  36. The next time Delphi is loaded, a new menu item 'Leviathan Install Expert'
  37. will appear on the help menu. Click this to invoke the expert.
  38.  
  39. Useage
  40. ------
  41.  
  42. There are 9 screens in the Expert process. These are described below:
  43.  
  44. 1) Application Name. This will be used to describe the application
  45.    in the SETUP program, and will also be the name of the program
  46.    manager group used to hold the installed files.
  47.  
  48. 2) Options: Check the relevant options applicable to the application
  49.    setup process. Compression will only be available if the Microsoft 
  50.    program COMPRESS.EXE is found in the Windows directory.
  51.  
  52. 3) Install drive. The expert will offer a list of available floppy and
  53.    removeable drives. Choose one to create the installation disks on.
  54.  
  55. 4) File list. Choose the files that need to be installed to make up
  56.    the application. Whenever this list is changed, the program manager
  57.    mappings are reset to their default values. Multiple files can be
  58.    selected by dragging the mouse in the file listbox. If extra tasks 
  59.    are being spawned, the files needed for them should NOT be defined
  60.    here. This window is for defining files for the applicaton setup ONLY.
  61.    See the notes on extra files for more information.
  62.  
  63.    An install path also needs to be set. There is no validation done on 
  64.    this path, so enter a full (valid) pathname.
  65.  
  66. 5) Program Manager mappings. A list of all executable and help files
  67.    is displayed. Navigate the list with the cursor keys or mouse and
  68.    type in the program manager name in the entry area at the bottom.
  69.    If the name is blank then no program manager item will be created.
  70.    If all items are blanked, then the program manager group will not
  71.    be created.
  72.  
  73. 6) BDE Alias. Define the name and path of the alias to be inserted
  74.    into the BDE upon setup. The alias type is always STANDARD.
  75.  
  76. 7) Ini Files. See separate note.
  77.  
  78. 8) External tasks. see seperate note.
  79.  
  80. 9) Create disks. Click the button to make a set of install disks.
  81.    If compression is selected then COMPRESS.EXE will be run from
  82.    DOS. After this, the system will prompt for formatted disks to
  83.    be inserted into the selected drive and the install files will
  84.    be copied.
  85.  
  86.  
  87. INI Files
  88. ---------
  89.  
  90. The Expert allows the editing or creation of INI files during the
  91. setup process. To edit an INI file, click the 'Include INI File'
  92. button. Enter the name of the INI file, then enter the section
  93. name, and finally the actual data to include in the section. This
  94. usually takes the form of 'Ident=Value'
  95.  
  96. If the section or item already exist in the specified INI file
  97. then the current values will be changed to reflect the new ones
  98. entered. If either section or item does not exist, it will be added.
  99. If the INI file does not exist it will be created, and the sections
  100. and items defined will be added to it.
  101.  
  102. Whenever a path needs to be defined in the INI file editor, whether
  103. it is a path to the INI file or a path used in a section, there
  104. are two substitutions that can be used:
  105.  
  106. %I will substitute the installaton directory chosen at install time.
  107. %W will substitute the current Windows directory.
  108.  
  109. so to modify the WIN.INI the path to the INI file is %W\WIN.INI.
  110.  
  111. Once you have started to add an INI file, you cannot 'cancel' the
  112. oprtation. If you change your mind, finish adding the file then remove
  113. it from the list.
  114.  
  115.  
  116. Extra Tasks
  117. -----------
  118.  
  119. It is sometimes desireable to run external tasks from an installation
  120. program. The most common use of this is to spawn a second, related
  121. install program such as a dongle installer, or to execute notepad with
  122. a set of release notes. The task definition list allows this by
  123. defining two items: The command line to execute (passed to WinExec) and
  124. (optionally) any other files that are needed to complete execution
  125. of this task. In the above example, the command line would be set
  126. to : 'notepad readme.txt' and the associated file would be 
  127. 'readme.txt'. Notepad is already on the system, so we do not need to
  128. copy that as well.
  129.  
  130. The outline view shows the tasks as folders, and any files needed
  131. to complete the task as items under the folder.
  132.  
  133. All the extra files needed are in the install script under the
  134. heading [ExtraFiles].
  135.  
  136. The Expert checks the free space on the current disk before copying
  137. extra files. All the extra files must reside on the same disk, so
  138. there cannot be a larger total extra filesize than the total disk 
  139. capacity. If there is not enough space on the current disk, the IE
  140. will prompt for an extra disk to complete the creation of the disks.
  141.  
  142. The extra files are also copied uncompressed, and not copied onto the
  143. destination disk at install time.
  144.  
  145. Other Notes
  146. -----------
  147. It is only possible to add one BDE alias at the current time.
  148.  
  149. Files are copied onto the installation floppy disks in the order that
  150. they occur in the listbox. Intelligent copying to save disk space
  151. may turn up, if I can be bothered.
  152.  
  153. COMPRESS.EXE is a M$ Product, so I can't include it with this software.
  154. It is a command line utility and can be found with the Visual Basic
  155. Setup Kit included with VB3 Pro. It can probably be found with other M$
  156. development tools. For the Installation Expert to use it, it must be in
  157. the windows directory (eg C:\WINDOWS).
  158.  
  159. INI Files are NOT backed up before being changed, and the user does NOT
  160. get asked whether they want their INI files stamped over. So if the change
  161. may need to be undone then document it somewhere with your program
  162. documetation.
  163.  
  164. To Do (sometime):
  165. -----------------
  166. Delete my temporary files from my temp directory!
  167. Install into a subdirectory structure.
  168. Specify files for windows and windows\system dirs.
  169. Text screen before/after install?
  170. Interbase BDE aliases?
  171.  
  172.  
  173. Thanks To:
  174. ----------
  175.  
  176. Nick Chappell,    }
  177. Sean Scaplehorn,  } For advice and helpful comments.
  178. Ian Stopher       }
  179.  
  180. Bradly Olsen      } BDE Alias setting code - but if you have any problems 
  181.             with that, come back to me...
  182.  
  183. The various Internet web pages and newsgroups for supplying me with the
  184. code snippets that I plagierized to make this application!
  185.  
  186. To contact me:
  187. --------------
  188.  
  189. Any comments, improvements or offers of 'cute, cartoony pictures' 
  190. can be Emailed to:
  191.  
  192. marc@leviathn.demon.co.uk.
  193.  
  194.