home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / i / inst30.zip / INST.DOC < prev    next >
Text File  |  1993-03-10  |  17KB  |  331 lines
  1.                           INST Installation Software
  2.                                  Version 3.0
  3.                                Elizabeth Copper
  4.                                  227 F Avenue
  5.                               Coronado, CA  92118
  6.                          Bulletin Board (619)-435-0036
  7.                          Voice Message  (619)-435-2687
  8.  
  9.  
  10. WHAT INST DOES:  This is a shareware program to enable shareware authors
  11. and corporate/business/governmental to create a custom installation
  12. front-end for nearly any software package.  INST was written to create a
  13. simple, menu-driven program to do this that would be less complicated
  14. and less costly than other packages available.
  15.  
  16. INST allows you to create a custom installation  for any software that:
  17.  
  18. +Displays a PCX logo (EGA/VGA only) and your company name.
  19.  
  20. +Checks the number of files in config.sys.
  21.  
  22. +Allows users to edit config and autoexec through a built-in editor.
  23.  
  24. +Checks video adapter, base memory and free disk space.
  25.  
  26. +Copies files to a default directory or user-selected directory.
  27.  
  28. +Supports multiple disk sets.
  29.  
  30. +Un-archives files in  self-extracting archives.
  31.  
  32. +Supports upgrade installs (locates your program on the user's hard disk
  33. and copies new files over old ones in the same subdirectory.)
  34.  
  35. +Displays five lines of text of your choice, your company name and the
  36. name of the software being installed.
  37.  
  38. INST does these things by creating an installation configuration file with
  39. your specifications.  You simply copy this file, INST.EXE and your PCX log
  40. (if any) to the distribution disk and instruct users to type INST to install
  41. your software.
  42.  
  43. QUICK START: To run the setup, type INST SETUP.  Type INST M SETUP to
  44. bring up monochrome screens.  Users type INST to install or INST M to
  45. install in monochrome.  NOTE: there are no slashes or dashes between
  46. parameters!
  47.  
  48. STARTING INST is simple:
  49.  
  50. To set up your specifications, type INST (M) SETUP and you will see the
  51. following screens.  INST M SETUP brings up monochrome:
  52.                                                                                 
  53. ┌──────────────────────────────────────────────────────────────────────────────┐
  54. │                         Software Installation Setup                          │
  55. │                    GROWLER SOFTWARE       (619)-435-2687                     │
  56. │ Enter number of disks in set:  1                                             │
  57. │ Enter required base memory (in Kbytes): 512                                  │
  58. │ Enter required number of file handles: 41                                    │
  59. │ Enter required minimum DOS version (at least 3.30): 3.30                     │
  60. │ Enter device driver or other CONFIG.SYS statement:                           │
  61. │ CONFIG.SYS statement:                                                        │
  62. │                                                                              │
  63. │ Enter environment variables for AUTOEXEC.BAT:                                │
  64. │ Environment variable 1:                                                      │
  65. │ Environment variable 2:                                                      │
  66. │ Environment variable 3:                                                      │
  67. │ Enter default drive for installation (C: through J: valid): C:               │
  68. │ Enter default directory for installation (no trailing backslash): \          │
  69. │ Enter program name:                                                          │
  70. │ Enter free disk space needed in Mbytes:  3                                   │
  71. │ Enter the names of up to four self-extracting archives (no extension) for    │
  72. │ INST to extract:  (1):           (2):           (3):           (4):          │
  73. │ Delete the self-extracting archive(s) and INST.EXE after installation? Y     │
  74. │ Enter DOS command to start program (no extension):                           │
  75. │ Enter company name: GROWLER SOFTWARE       (619)-435-2687                    │
  76. └──────────────────────────────────────────────────────────────────────────────┘
  77.  
  78. Number of disks in set: INST handles multiple disk sets to be in one
  79. subdirectory.  User are prompted "insert disk two, three, etc."  Volume
  80. labels are NOT checked.
  81.  
  82. Base memory: INST checks installed base memory only, not free or EMS/XMS memory.
  83. HINT: If you application needs 640K, use 630K to avoid install failures
  84. under DESQVIEW and other multitaskers that report less than 640K base
  85. memory per task/window.
  86.  
  87. File handles: The file handles check is through a BIOS call, not by
  88. reading config.sys. This will more reliably report actual file handles.
  89. Network handles are not checked.
  90.  
  91. DOS version: The DOS version check is through the standard call.  YOU
  92. MUST SPECIFY AT LEAST DOS 3.30 FOR INST TO FUNCTION PROPERLY!
  93.  
  94. CONFIG.SYS statement: Enter exactly as the user should type it into the
  95. CONFIG.SYS file.  If you make an entry here, the user will be given a
  96. popup edit screen with config.sys and told to look for or add the line
  97. you specify.  If edit is exited with SAVE (CtrlW), the original
  98. config.sys file will be saved as config.z$z.  Be sure the line is
  99. EXACTLY as it should be typed in, e.g.: DEVICE=ANSI.SYS.
  100.  
  101. AUTOEXEC.BAT environment variables/lines to add: Enter exactly as the
  102. user should type into the AUTOEXEC.BAT file.  If you make an entry here,
  103. the user will be given a popup edit screen with autoexec.bat and told to
  104.  
  105. look for or add the lines you specify.  If edit is exited with SAVE
  106. (CtrlW), the original autoexec.bat file will be saved as autoexec.z$z.  Be
  107. sure the lines are EXACTLY as they should be typed in,
  108. e.g.: SET TMP=C:\TMP, SET CLIPPER=//F45, etc.
  109.  
  110. Enter the default drive and directory for installation, required free space
  111. in Mbytes (add the total bytes on your distribution disk to the total
  112. unarchived size of your program).  Unless you specify UPGRADE INSTALL
  113. (see below), INST requires installation to a subdirectory that does not
  114. already exist to prevent overwriting some other program or files.  If
  115. your default directory exists, INST will prompt the user to enter
  116. another directory name.  INST checks for invalid drives and directories.
  117.  
  118. Enter the names of up to four self-extracting archives (no extension).
  119. You may choose to have the archive(s) and INST deleted from the
  120. destination directory after installation.  This is a good idea to
  121. prevent users from trying multiple installs and wiping out their data.
  122.  
  123. Enter the DOS command to start the program, with no extension. Enter your
  124. company name.
  125.  
  126. NOTE: Buffers are not checked because they are less consequential with
  127. the use of disk caches and because many users load them in high memory.
  128.  
  129. The second screen below handles upgrade installs, video options and five
  130. lines of text to display:
  131.  
  132. ┌──────────────────────────────────────────────────────────────────────────────┐
  133. │                         Software Installation Setup                          │
  134. │                    GROWLER SOFTWARE       (619)-435-2687                     │
  135. │                                                                              │
  136. │ Do you want to permit upgrade installs? (Have INST detect your program       │
  137. │ and copy the files on the disk over the existing files.) Y/N: Y              │
  138. │ Enter the name of the program file to locate (with extension): JUNK.EXE      │
  139. │ Enter required minimum video display adapter (A-Any, E-EGA, V-VGA): A        │
  140. │ PCX logo (filename.PCX) to display (EGA/VGA only):                           │
  141. │ Display logo for how many seconds (unless a key is pressed)?  7              │
  142. │ Enter up to five lines of text to display on configuration screen:           │
  143. │ Line 1:                                                                      │
  144. │ Line 2:                                                                      │
  145. │ Line 3:                                                                      │
  146. │ Line 4:                                                                      │
  147. │ Line 5:                                                                      │
  148. │ Center or left-justify these lines (C/L)? C                                  │
  149. └──────────────────────────────────────────────────────────────────────────────┘
  150.  
  151. UPGRADE INSTALLS:  If you answer N to this question, INST will require
  152. an install to a subdirectory that does not already exist.  This is to
  153. prevent users from copying your program into a subdirectory that already
  154. contains something else.
  155.  
  156. If you want to permit upgrade installs, answer Y to this question.  An
  157. upgrade install is one in which you want the user to copy all the files
  158. on the disk(s) over older versions of the same files in a particular
  159. subdirectory.  If you answer Y, you then need to enter the name of the
  160.  
  161. file to look for on the users hard disk to locate your program.  This
  162. can be any file associated with you program, and does not have to the
  163. EXE file. When INST is run, the program will then search for that file
  164. and if it finds it, ask the user if (s)he want to install to the
  165. directory where it was found.  If the user says "No", or if INST cannot
  166. find the file, the normal INST install will proceed to a new directory.
  167.  
  168. USE THIS OPTION WITH CARE!  If you tell INST to look for the file
  169. JUNK.EXE and there are two JUNK.EXE files on the hard disk, INST will
  170. select the first.  If it is not your program, INST could wipe out some
  171. other program, making your user very unhappy.  Specify a filename that
  172. is unlikely to belong to anything other than your program. It can be a
  173. datafile, configuration file or anything.  Remember INST will copy only
  174. the files on the distribution disk over those on the hard disk, so it is
  175. safe to specify a filename that is not one that will or should be copied
  176. over.  IF YOU USE THIS OPTION, TEST IT BEFORE DISTRIBUTING!
  177.  
  178. Enter the name of a PCX logo to display: Enter a filename with the .PCX
  179. extension.  INST supports the following PCX formats, with a maximum PCX
  180. file size of 64Kbytes:
  181.  
  182. VGA -     320x200x256, video mode 13h
  183. VGA -     640x480x16, video mode 12h
  184. EGA/VGA - 640x350x16, video mode 10h
  185.  
  186. CGA, MDA and MGA are not supported.  INST checks the display adapter and
  187. skips display if VGA/EGA are not present.
  188.  
  189. Limitations and requirements:
  190.  
  191. THE MOST IMPORTANT REQUIREMENT is: Once you have completed your
  192. selections, TEST YOUR INSTALLATION TO BE SURE IT DOES WHAT YOU THINK IT
  193. SHOULD!
  194.  
  195. PLEASE EXPERIMENT WITH THE PROGRAM AND TEST YOUR INSTALLATIONS TO BE
  196. SURE INST DOES WHAT YOU WANT AND WHAT YOU THINK YOU HAVE TOLD IT TO DO.
  197. ANY PROGRAM THAT MAKES SUBDIRECTORIES, COPIES FILES AND ALLOWS EDITING
  198. OF CONFIG.SYS AND AUTOEXEC.BAT DESERVES TO BE TREATED AS A POTENTIALLY
  199. DANGEROUS TOOL IF USED IMPROPERLY OR WITH MISTAKEN PARAMETERS!
  200.  
  201. Installation is permitted to drives C: through J: only.
  202. Installation is permitted only to new directories (except when upgrading).
  203. INST handles only one self-extracting arhive file per disk or disk set.
  204. Self-extracting archives must not contain any auto-run batch files.  They
  205. must simply extract the files and must be in self-extracting archive (.EXE)
  206. format.  PKZIP 1.10 and 2.04g, and LHA have been tested.
  207.  
  208. Why INST?  INST was chosen to avoid conflicting with the name INSTALL.
  209.  
  210. INST was written in Clipper 5.01a, linked with FREELINK into a
  211. non-overlay file and compressed with LZEXE to reduce its size.  The size
  212. of INST.EXE should not be a drawback for most programs, especially if
  213. you distribute self-extracting archives on 720K-1.2M-1.4M floppies.
  214.  
  215. Your users will see a screen similar to the one below, and if the need
  216. to edit config.sys or autoexec.bat, an editor screen will pop up
  217. prompting them to add lines, check the files=nn line, etc.
  218.  
  219. ┌──────────────────────────────────────────────────────────────────────────────┐
  220. │                   Daily Calendar Version 5.0 Installation                    │
  221. │                    GROWLER SOFTWARE       (619)-435-2687                     │
  222. │                                                                              │
  223. │ Memory check: 640K required, 640K found.                  +Memory check OK.  │
  224. │ Files check: 41 required, 79 found.                       +Files number OK.  │
  225. │ DOS version check: 3.30 required, 3.31 found.             +DOS version OK.   │
  226. │ Minimum video adapter check: ANY required, VGA found.     +Video check OK.   │
  227. │                                                                              │
  228. │ What is your boot drive? C:                                                  │
  229. │ Drive on which to install program: C:                                        │
  230. │ Directory in which to install program: \DAY                                  │
  231. │                                                                              │
  232. └──────────────────────────────────────────────────────────────────────────────┘
  233.  
  234. REGISTRATION:
  235.  
  236. If you obtained this software from a shareware distribution service, you
  237. have paid only for the cost of distribution.  You have not registered it.
  238. Basic, individual registration is $20.  If this software is used in a
  239. business/corporate/government setting, a site license is required, as
  240. explained on the registration page that follows.
  241.  
  242. INST is shareware, it is not free or public domain. If you use it for more
  243. than thirty days, you are expected to register it. Use beyond this period
  244. without registration violates a variety of laws, but more importantly denies
  245. the author minimal, just compensation for the software.
  246.  
  247. This program and associated documentation are the property of the author
  248. and may not be sold without permission.  The program may be freely
  249. distributed, unaltered and as a unit, via electronic bulletin board
  250. systems.  Permission to distribute on diskette or in any other manner must
  251. be obtained in writing.
  252.  
  253. WARRANTY:
  254.  
  255. The author does not guarantee this program to be free from defects and may
  256. not be held responsible for loss caused by it.  Your use of this program
  257. constitutes your acceptance of these terms.
  258.  
  259. Users of INST must accept this disclaimer of warranty: INST is supplied as
  260. is.  The author disclaims all warranties, expressed or implied, including,
  261. without limitation, the warranties of merchantability and of fitness for any
  262. purpose. The author assumes no liability for damages, direct or
  263. consequential, which may result from the use of INST.
  264.  
  265. SUPPORT:
  266.  
  267. Support is provided for registered and non-registered users through the
  268. Bulletin Board (619)-435-0036 and voice message (619)-435-2687.
  269. Bulletin Board support is the best way to get help.  Call the board and
  270. leave a message.  An answer will be posted within 36 hours.
  271.  
  272. March, 1993
  273.  
  274. REGISTRATION FORM:
  275.  
  276.                           INST Installation Software
  277.                                  Version 3.0
  278.                                Elizabeth Copper
  279.                                  227 F Avenue
  280.                               Coronado, CA  92118
  281.                          Bulletin Board (619)-435-0036
  282.                          Voice Message  (619)-435-2687
  283.  
  284. TO REGISTER:
  285.  
  286. You are registering the copy you have, which is the fully functional
  287. program.  Your registration will be acknowledged and if there is a new
  288. version, you will receive it.
  289.  
  290. Print this form, complete it and send it with $20 to the address above.
  291. PLEASE MAKE THE CHECK PAYABLE TO ELIZABETH COPPER. Please use this form
  292. or be sure to let us know you are registering Version 3.0.
  293.  
  294. Name_________________________________________________________________
  295.  
  296. Address______________________________________________________________
  297.  
  298. City______________________________________State_____Zip______________
  299.  
  300. Is 3½ disk size OK? ___YES ___No, send 5¼ disk.
  301.  
  302. Registered users also have special access to the Bulletin Board and reduced
  303. prices on other Growler Software products.
  304.  
  305. Pricing:
  306.  
  307. Single user rate.................................................$ 20.00
  308. This is the rate for an individual using this software in a non-corporate,
  309. non-institutional setting.  This is the rate for shareware authors who do
  310. business as individuals.  Individual shareware authors may distribute
  311. INST with their applications with no royalties.
  312.  
  313. Site licenses are REQUIRED for all corporate, institutional, government,
  314. education and business users.  This software will save you far more in
  315. time thanthe site license costs
  316.  
  317. Site license rate, one physical site, unlimited users............$125.00
  318. This is the rate for a company using INST as an in-house installation
  319. tool.
  320.  
  321. Site license rate, unlimited physical sites, unlimited users.....$250.00
  322. This is the rate for multiple-site companies, software distributors and
  323. software companies for unlimited use.  (If you are a software
  324. distributor or software company, royalty arrangements can be made.
  325. Customization and other special services are also available.)
  326.  
  327. Government, education and public benefit non-profits, 10% off prices
  328. above.
  329.  
  330.  
  331.