home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / UTILS / IMPRES21 / IMPRESS.DOC < prev    next >
Text File  |  1992-07-01  |  42KB  |  915 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               First Impression
  10.                      Your Professional Installation Kit
  11.  
  12.                              Written & Published
  13.                                      By
  14.                            Lincoln Beach Software
  15.                              Copyright (c) 1992
  16.                              ALL RIGHTS RESERVED
  17.  
  18.  
  19.                                _______
  20.                           ____|__     |               (tm)
  21.                        --|       |    |-------------------
  22.                          |   ____|__  |  Association of
  23.                          |  |       |_|  Shareware
  24.                          |__|   o   |    Professionals
  25.                        -----|   |   |---------------------
  26.                             |___|___|    MEMBER
  27.  
  28.  
  29.  
  30. FIRST IMPRESSION
  31. "Your Installation Program"
  32.  
  33. LIABILITY WAIVER. . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  34.  
  35. SUPPORT AND SHAREWARE
  36.                                   STATEMENT . . . . . . . . . . . . . .   1
  37.  
  38. PLEA FOR FREE ADVERTISEMENT . . . . . . . . . . . . . . . . . . . . . .   2
  39.  
  40. IMPRESSION MENU OPTIONS . . . . . . . . . . . . . . . . . . . . . . . .   4
  41.       BASIC INSTALLATION. . . . . . . . . . . . . . . . . . . . . . . .   4
  42.       INSTALL ENHANCEMENTS. . . . . . . . . . . . . . . . . . . . . . .   4
  43.       SELECTING FILES TO COPY . . . . . . . . . . . . . . . . . . . . .   7
  44.       DOS INSTRUCTIONS. . . . . . . . . . . . . . . . . . . . . . . . .   8
  45.       FILE BROWSER. . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  46.       DOCUMENTS TO PRINT. . . . . . . . . . . . . . . . . . . . . . . .   9
  47.       REGISTRATION WINDOW . . . . . . . . . . . . . . . . . . . . . . .  10
  48.       FILE COPY DISPLAY . . . . . . . . . . . . . . . . . . . . . . . .  10
  49.       VIEW BASIC INSTALL. . . . . . . . . . . . . . . . . . . . . . . .  10
  50.       MEDIA SELECTION STYLE . . . . . . . . . . . . . . . . . . . . . .  10
  51.       GENERATE DISTRIBUTION DISKS . . . . . . . . . . . . . . . . . . .  11
  52.       LOADING AND SAVING CONFIGURATIONS . . . . . . . . . . . . . . . .  11
  53.       SHELL TO DOS. . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  54.  
  55. COMPLETION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  56.  
  57. INSTALLATION FLOWCHART. . . . . . . . . . . . . . . . . . . . . . . . .  12
  58.  
  59. CUSTOMIZABLE WINDOW INSTALLATION. . . . . . . . . . . . . . . . . . . .  14
  60.  
  61. UNINSTALL OPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  62.  
  63. INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  64.  
  65.                               ACKNOWLEDGEMENTS
  66.  
  67. Thanks to my wife for putting up with me during all of this and
  68. to God for giving me the knowledge and skill to do this.
  69.  
  70.                               LIABILITY WAIVER
  71.  
  72. FIRST IMPRESSION IS LICENSED "AS-IS".  LINCOLN BEACH SOFTWARE
  73. MAKES NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO
  74. THIS PROGRAM, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR
  75. FITNESS FOR ANY PARTICULAR PURPOSE.  IN PARTICULAR IT IS NOT
  76. GUARANTEED TO PREVENT OR DETECT DAMAGE TO YOUR DATA OR PROGRAMS. 
  77. IN NO EVENT SHALL LINCOLN BEACH SOFTWARE BE LIABLE FOR ANY CLAIMS
  78. FOR LOST PROFITS OR ANY DAMAGE, INCLUDING, BUT NOT LIMITED TO,
  79. SPECIAL, INCIDENTAL, CONSEQUENTIAL OR OTHER DAMAGE.  SOME STATES
  80. DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR
  81. CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY
  82. NOT APPLY TO YOU.  IN NO CASE SHALL LINCOLN BEACH SOFTWARE'S
  83. LIABILITY EXCEED THE LICENSE FEES PAID FOR THE RIGHT TO USE THE
  84. LICENSED SOFTWARE.  THE LICENSE AGREEMENT AND WARRANTY SHALL BE
  85. CONSTRUED, INTERPRETED AND GOVERNED BY THE LAWS OF THE STATE OF
  86. MISSOURI.
  87.  
  88.                       COPYRIGHT, SUPPORT AND SHAREWARE
  89.                                   STATEMENT
  90.  
  91. FIRST IMPRESSION is a "shareware program" and is provided at no
  92. charge to the user for evaluation.  Feel free to share it with
  93. your friends, but please do not give it away altered or as part
  94. of another system.  The essence of "user-supported" software is
  95. to provide personal computer users with quality software without
  96. high prices, and yet to provide incentive for programmers to
  97. continue to develop new products.  If you find this program
  98. useful and find that you are using FIRST IMPRESSION and continue
  99. to use FIRST IMPRESSION after a trial period not to exceed 30
  100. days, you must make a registration payment of $45 to LINCOLN
  101. BEACH SOFTWARE.  The $45 registration fee will license one copy
  102. for use on any one computer at any one time.  You must treat this
  103. software just like a book.  An example is that this software may
  104. be used by any number of people and may be freely moved from one
  105. computer location to another, so long as there is no possibility
  106. of it being used at one location while it's being used at
  107. another.  Just as a book cannot be read by two different persons
  108. at the same time.  Also installation procedures may be developed
  109. solely for the company it is licensed to.  You may not develop
  110. installations for other firms.
  111.  
  112. Corporate users of FIRST IMPRESSION must register and pay for
  113. their copies by departments and site-License arrangements may be
  114. made by contacting LINCOLN BEACH SOFTWARE.
  115.  
  116. Special Licensing agreements are available for consulting firms
  117. that develop software packages for clients.  Remember, you many
  118. not develop installations for other firms.
  119.  
  120. You are encouraged to pass a copy of FIRST IMPRESSION along to
  121. your friends for evaluation.  Please encourage them to register
  122. their copy if they find that they can use it.  All registered
  123. users will receive a copy of the latest version of the FIRST
  124. IMPRESSION system and printed documentation.
  125.  
  126. This software and documentation is protected under the United
  127. States Copyright Laws and International Treaty Provisions.  Your
  128. support of Shareware is appreciated.
  129.  
  130. You may call 314-227-2431 or write to us at: Lincoln Beach
  131. Software, P.O. Box 1554, Ballwin, MO 63022-1554 if you have any
  132. questions.  If no one is there to personally answer your call,
  133. leave a message and we will get back to you ASAP.  You may also
  134. send questions to me on CompuServe by directing your mail to: 
  135. Harold Holmes, CompuServe ID: 70700,630.
  136.  
  137.                          PLEA FOR FREE ADVERTISEMENT
  138.  
  139. It would be greatly appreciated if you would put the following
  140. paragraph into your documentation.  However, it is not required. 
  141.  
  142. THE INSTALLATION PROGRAM USED BY <your company or program name>
  143. WAS WRITTEN BY LINCOLN BEACH SOFTWARE AND IS ENTITLED FIRST
  144. IMPRESSION.  LINCOLN BEACH SOFTWARE RESERVES ALL COPYRIGHT
  145. PROTECTION WORLDWIDE.  FOR FURTHER INFORMATION THEY MAY BE
  146. REACHED AT P.O. BOX 1554, BALLWIN, MO 63022 OR 314-227-2431.
  147. HAROLD HOLMES MAY ALSO BE REACHED ON COMPUSERVE AT 70700,630.
  148.  
  149.                              Ombudsman Statement
  150.     First Impression is produced by a Lincoln Beach Software, a
  151. member of the Association of Shareware Professionals (ASP).  ASP
  152. wants to make sure that the shareware principle works for you. If
  153. you are unable to resolve a shareware-related problem with an ASP
  154. member by contacting the member directly, ASP may be able to
  155. help. The ASP Ombudsman can help you resolve a dispute or problem
  156. with an ASP member, but does not provide technical support for
  157. members' products.  Please write to the ASP Ombudsman at 545
  158. Grover Road, Muskegon, MI 49442 or send a CompuServe message via
  159. CompuServe Mail to ASP Ombudsman 70007,3536.
  160.  
  161.                                    FORWARD
  162.  
  163. FIRST IMPRESSION, or IMPRESSION, allows users to install your
  164. software easily and also save you development time by not having
  165. to create your own install procedures.
  166.  
  167. The basis of this software consists of two programs, IMPRESS.EXE
  168. and INSTALL.EXE.  With these tools you can create a customized
  169. install program for many applications.  IMPRESSION will take you
  170. through several steps to personalize your install.  Once you
  171. complete the design, copy the INSTALL.EXE and INSTALL.CFG files
  172. to the distribution disk.  Then on the label write A:INSTALL.
  173.  
  174. A few features IMPRESSION offers developers are the ability for
  175. the user to select the source or destination drive and
  176. subdirectory, to print any documentation included, checks the
  177. destination to confirm there is enough space to install the
  178. software, hard code registered users name into your program, the
  179. ability to utilize compress files using your own compression
  180. utility, and it will also add the subdirectory to the path
  181. statement if the user wishes to and automatically update the
  182. CONFIG.SYS file if necessary.  There are other features that you
  183. will see along the way as you create your configuration file.
  184.  
  185. IMPRESSION will utilize a mouse, if one is installed.  Logitech
  186. and Microsoft mice will work as will others as long as they are
  187. compatible.
  188.  
  189.  
  190. Color attributes used for a window are:
  191.  
  192.  Background/Foreground       Foreground 
  193.  
  194.         0=BLACK               8=DARK GRAY
  195.         1=BLUE          9=LIGHT BLUE
  196.         2=GREEN              10=LIGHT GREEN
  197.         3=CYAN         11=LIGHT CYAN
  198.         4=RED          12=LIGHT RED
  199.         5=MAGENTA      13=LIGHT MAGENTA
  200.         6=BROWN              14=YELLOW
  201.         7=LIGHT GRAY         15=BRIGHT WHITE
  202.  
  203. There are no bounds checking when using attributes with the
  204. constructable windows.  By adding eight (8) to the background
  205. color the character will blink on the screen.
  206.  
  207. At any field hit the F1 key for help on filling out that
  208. particular field.
  209.  
  210.                            IMPRESSION MENU OPTIONS
  211.  
  212.                              BASIC INSTALLATION
  213.  
  214. There are three screens that appear during the installation. 
  215. They are titled Greeting, Program and Copy window.  After
  216. selecting one of these windows another menu will appear allowing
  217. you to change the window attributes, change the text in the
  218. window and finally show the window as it will appear or return to
  219. the previous menu.  When setting up these windows be sure to put
  220. in values in the attribute columns.  If they are left blank it
  221. will appear BLACK on BLACK and will not be visible.
  222.  
  223.                               WINDOW ATTRIBUTES
  224. This option sets the way the window will appear.  The first two
  225. fields are the settings for the foreground and background colors
  226. for the border.  The third is the color for the window
  227. background.  There is no choice for the window foreground color
  228. since the attributes for the text are set in the text option.
  229.  
  230. The next option is for the window type.  They are 1=Normal,
  231. 2=Shadowed, 3=Exploding, 4=Borderless.
  232.  
  233. Then last option is a Yes/No prompt to change the border of the
  234. window.  If you enter a 'Y' in this field you will be taken to a
  235. screen that will give you eight (8) choices after you exit this
  236. form.  The first four choices utilize the line draw characters
  237. and the last four use the different shades of box characters.
  238.  
  239.                                TEXT ATTRIBUTES
  240. When this option is selected a screen will appear to enter the
  241. text in that will appear in the window.  After entering the text
  242. you are prompted for the row that the text will appear on.  If
  243. you enter a number that is not in the range it will not appear in
  244. the window.  Next enter the attributes that the text will 
  245. appear in within the window.
  246.  
  247.                                  SHOW WINDOW
  248. This option will put the window that has been designed on the
  249. screen at the location it will be in during the installation.
  250.  
  251. The final menu option will return you the previous menu to work
  252. on another window.
  253.  
  254.  
  255.                             INSTALL ENHANCEMENTS
  256.  
  257. The menu option INSTALL ENHANCEMENTS will take care of all
  258. personalized installation requirements.  As you will see there
  259. are many options.  This will enable your install to be as
  260. specific as necessary.  
  261.  
  262. The first option is for the default subdirectory into which the
  263. user is encouraged to install the software into.  The user may
  264. change this during the installation.  Nested subdirectories may
  265. be used as well such as \WP51\MYPROG.
  266.  
  267. The next option will force the user to install your application
  268. into the directory that you have set up as the default directory.
  269.  
  270. The next item is the name of the batch file that you wish to
  271. create in the root directory.  It must contain the extension
  272. .BAT.  An error message will appear if it is missing.  If no
  273. batch file is specified, none will be created.
  274.  
  275. The next two items are added to the batch file if one is created. 
  276. The first is the name of the program that is called from the
  277. batch file.  This is generally the developers application.  If an
  278. application tool is used such as Clarion Developer or dBase then
  279. this should appear in the FILE TO EXECUTE field and the
  280. application that has been developed would appear in the COMMAND
  281. LINE ARGUMENTS field.  In the batch file it would appear as:  
  282.  
  283.             DBASE.COM DATABASE.DBF
  284.  
  285. The option of hard coding the users name into an application is
  286. also available.  Answer a 'Y' to invoke this option.  After
  287. finishing the ENHANCEMENT form a window will appear prompting for
  288. the file to be coded while on the S)ource disk or the
  289. D)estination disk.  Following this another window appears with
  290. two empty fields.  Two files may be coded.  Enter the name(s) in
  291. the field(s).  You should test this before sending out your
  292. application.  You are allowed 50 characters, and you must have a
  293. field in your program predefined such as the following line:
  294.  
  295. char company_name[51]="$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$";
  296.  
  297. This is an example of how to create the needed field in the 'C'
  298. language.  You need a field that contains no more and no less
  299. than fifty (50) dollar signs. The INSTALL program searches for
  300. this and replaces it with the registered users name.  Some
  301. programs may not be able to use this such as Dbase files.  Such
  302. files have not been tested so you will have to try it on your
  303. own.  If you choose to code the files while they are on the
  304. source disk they must reside on the first application disk.  Also
  305. if you compress your executable by using PKLITE or LZEXE it will
  306. not work.
  307.  
  308. By entering in the number of k in the field for SPACE NEEDED ON
  309. DESTINATION DRIVE, the destination drive will be checked for the
  310. necessary space.  If it does not exist the user is informed that
  311. there is not enough space and the install is aborted.  Note:
  312. 1000k=1MB.
  313.  
  314. If the application being used needs a minimum DOS version it may
  315. be entered here at the DOS VERSION NEEDED field.  If the user is
  316. running an older version of DOS than is required a message will
  317. appear informing the user and will then abort.  The first half of
  318. the field is the major version like 4 and the second half would
  319. be the minor portion or .01.  This would make up 4.01.
  320.  
  321. The next two fields are used to update the FILES and BUFFERS
  322. statements in the CONFIG.SYS file.  Leaving this blank will
  323. bypass this function.  If the CONFIG.SYS file is edited the
  324. original is renamed to CONFIG.HLD.  If you insert a value in one
  325. field and not the other it will only check/change the one that
  326. has the value.
  327.  
  328. The next two menu options are for adding device drivers to the
  329. CONFIG.SYS file.  Type in the name of the device driver that you
  330. wish to load in fields available.  These files must exist in the
  331. base directory that the software is being installed to.  The
  332. line(s) created in the config.sys file will look like: 
  333. DEVICE=C:\MYPROG\DRIVER.SYS and will be the first lines in the
  334. config.sys file.
  335.  
  336. If a minimum amount of base memory is required it may be entered
  337. here.  It checks up to 640k.  If there is not enough memory the
  338. install will abort.
  339.  
  340. The next two fields are for checking the existence of a math
  341. coprocessor and game port.  There are three valid entries for
  342. these fields.  They are:
  343.  
  344.       'C': Critical;  A message is displayed regarding the absence
  345.       of the device and the install will abort.
  346.  
  347.       'H': Helpful;  A message is displayed stating that the
  348.       program will run without the device but it would be helpful
  349.       if one existed.  The installation will continue after a key
  350.       is pressed.
  351.  
  352.       'N': No;  The component is not needed and will not be
  353.       checked for.
  354.  
  355. If sound is desired during the installation process select a 'Y'
  356. for the option to USE SOUNDS DURING INSTALL.  If an error has
  357. occurred a single low tone will sound.  If the user is prompt to
  358. change a disk or enter something, a chime will sound.  Select an
  359. 'N' to disable the sound.
  360.  
  361. If you do not want the user to have the option to put the
  362. selected subdirectory into the path enter a 'Y' in this last
  363. field and it will not prompt the user and will NOT put it in the
  364. path statement.  If the user does have the ability to modify the
  365. AUTOEXEC.BAT file the original is renamed to AUTOEXEC.HLD if it
  366. is modified.
  367.  
  368. Another option that can be selected is to create an ENVIRONMENT
  369. variable in the autoexec.bat file.  This will create a line in
  370. the users autoexec.bat file that will set a environment variable
  371. to the subdirectory your software was installed.  Setting the
  372. field to IMPRESSION will create the line: SET IMPRESSION =
  373. C:\IMPRESS Providing the subdirectory that the software was
  374. installed to was C:\IMPRESS.
  375.  
  376. The final enhancement field is for a program that you wish to
  377. execute immediately after the installation is complete.  For
  378. example, if you have your own printer configuration program or
  379. setup program.  If an exit program is specified the user is not
  380. returned to the INSTALL program
  381.  
  382.                            SELECTING FILES TO COPY
  383.  
  384. When the menu option FILES TO COPY is selected, a form will
  385. appear where you can enter the files to be copied from the source
  386. disk.  The files will be copied in the order they were entered on
  387. the form. There can be no blank entries between filenames such
  388. as:
  389.  
  390.       !DISK #1
  391.       myprog.pak
  392.       unpack.exe
  393.       Progr??.exe
  394.       &myfile.fil
  395.       ____________
  396.       mydata.dat
  397.  
  398. If this occurs the file mydata.dat and anything following that
  399. will not be copied to the destination.  Up to 54 file filters can
  400. be selected for copying.  Multiple disks can be used.  If a
  401. certain file cannot be found it prompts for the correct diskette
  402. or to abort.  The user should insert the diskette and press any
  403. key and it will try again.  Wildcards may be used as shown.
  404.  
  405. Note that the first name in the list of files starts with an (!)
  406. exclamation mark.  By doing this, a prompt will appear
  407. instructing the user to insert the disk labeled 'DISK #1'.  After
  408. the user hits a key, the installation program will start
  409. searching for files to copy.
  410.  
  411. If the user tries to reinstall the application, the install will
  412. search the directory and if the first file exists it will prompt
  413. the user asking if a reinstall is desired.  If no, the install is
  414. aborted.  It only checks the first file.
  415.  
  416. If you do not want to type in file names you can enter in the
  417. information as follows:
  418.  
  419.       !Disk #1
  420.       *.*
  421.       !Disk #2
  422.       *.*
  423.       !Disk #3
  424.       *.*
  425.       (more as needed)
  426.  
  427. This will copy all the files on each disk and prompt the user for
  428. each consecutive disk.
  429.  
  430.                               DOS INSTRUCTIONS
  431.  
  432. This option will give you 15 lines that can be used to enhance
  433. the install.  Such uses would be if you have compressed files
  434. that you are copying and wish to decompress them.  All of 
  435. these commands are executed from within the subdirectory created
  436. during the install.  An example would be that after you have
  437. copied all of the files over to the destination you would be able
  438. to unpack the files and then delete the packed file and other
  439. files that are not needed.  Using the file list in the lines in
  440. SELECTING FILES section you would have the following this
  441. section:
  442.  
  443.           unpack myprog.pak >nul
  444.           &myfile.fil
  445.  
  446. The file named &MYFILE.FIL would contain the lines below to set
  447. up the software in multiple directories.
  448.  
  449.           MD MYSUB
  450.           RELOCATE *.DAT MYSUB
  451.           DEL MYPROG.PAK
  452.           DEL &MYFILE.FIL
  453.  
  454. If the &myfile.fil approach is used only three commands are
  455. valid.  These are MD for make directory, RELOCATE which will move
  456. files and DEL which deletes files.  If RELOCATE is used it will
  457. copy the file and delete it automatically.
  458.  
  459. If you are using the DEVICE DRIVER option DO NOT move them from
  460. the base directory.
  461.  
  462. Normal batch files may be used if desired but sometimes the
  463. screen has been known to scroll up during the operation.  By
  464. create a file like &MYFILE.FIL all copy routines are performed by
  465. internal code and will not change the screen.  Note that the
  466. filename must begin with an & sign and the rest can be any valid
  467. filename character.
  468.  
  469. When installing software it can not be determined beforehand
  470. where a user wants to install the software so if the command
  471. A:PKUNZIP A:MYPROG.ZIP C: would not work if the user was
  472. installing from B: to D:.  This problem can be resolved by using
  473. the parentheses in the command and it will be filled in during
  474. the installation.  To do this simply make the previous command
  475. line appear as:
  476.       
  477.       (:PKUNZIP (:MYPROG.ZIP ):
  478.  
  479. During the process of this line it will be changed to:
  480.  
  481.       B:PKUNZIP B:MYPROG.ZIP D:
  482.  
  483. The open parentheses '(' is replaced by the source drive and the
  484. close parentheses ')' is replaced by the destination drive.
  485.  
  486. DOS command functions are handled as if you are at the command
  487. prompt.  If you reference any external DOS command, it must be in
  488. the path the user has setup, otherwise the commands will not
  489. work.  Be aware that all commands are executed "behind" the
  490. window that the user sees.  If in the case of using a program
  491. that unpacks a file the file already exists, it would normally
  492. display a message saying: "files exits, replace it(Y/N)?".  The
  493. user will not see this and the system could appear to have locked
  494. up when in reality a simple press of the 'Y' will allow it to
  495. continue.
  496.  
  497. The way to avoid this is to see if there is a command line option
  498. that will unpack it whether it exists or not.  See your specific
  499. "unpacker" to find out how it is done.  For example PKUNZIP from
  500. PKWARE, Inc. has the option [-o] to overwrite existing files
  501. whereas another popular compression program LHA, which creates
  502. files with the LZH extension, does not have an overwrite option
  503. and could cause this problem if a file already exists.
  504.  
  505.                                 FILE BROWSER
  506.  
  507. You may let the user browse up to four (4) 'READ ME' files. 
  508. Enter in the name(s) of the file(s) in this section that you want
  509. the user to be able to browse.  If you are using the BASIC
  510. install the 'READ ME' files may not exceed 35k each, and if you
  511. are using the INSTALL.WIN file then the 'READ ME' files may not
  512. exceed 20k each.  Unless of course you want the program to crash
  513. into oblivion and die.  Consider yourself warned.
  514.  
  515.                              DOCUMENTS TO PRINT
  516.  
  517. This menu option allows text files to be printed out to a
  518. selected printer.  The INSTALL program will sense if more than
  519. one printer port exists and give the user the choice of ports to
  520. print to.  Up to ten filename filters can be specified for
  521. printing.  This includes wildcards.
  522. When the user prints out documentation files and there are
  523. multiple printer ports INSTALL will sense this and give the user
  524. the option to print to available ports 1-3.
  525.  
  526.  
  527.  
  528.                              REGISTRATION WINDOW
  529.  
  530. The window that appears to have the user type in the registered
  531. user name is set up under this menu option.  If the choice to
  532. hard code the user name into an application is selected this
  533. window will appear.  Select the menu options in this section to
  534. set up the attributes of this window the same as you would for
  535. the basic windows.
  536.  
  537.                               FILE COPY DISPLAY
  538.  
  539. To give the user something to look at while the files are being
  540. copied or printed one of these options may be selected.  The
  541. first four are just for amusement.  Options 5 and 6 will show the
  542. percentage complete of the current file.  This display will
  543. appear when files are being copied from the source to the
  544. destination and while documents are being printed.
  545.  
  546.                              VIEW BASIC INSTALL
  547.  
  548. This option will show you each window in turn as it will appear
  549. during the installation. 
  550.  
  551.                             MEDIA SELECTION STYLE
  552.  
  553. There are two options that may be used for having the user select
  554. the source and destination drive and subdirectory.
  555.  
  556. Option #1 will display a window to show the user which floppy
  557. drives are available to install from.  After the user selected
  558. the drive to install from, let us say A:, another window will
  559. appear showing all the drives that exist to install the software
  560. on.  Following this window another window will appear prompting
  561. the user for the subdirectory to install to.  If one was entered
  562. in the INSTALL ENHANCEMENTS it will appear in the field.  The
  563. user may change this unless the option to not let the user change
  564. this was set in the INSTALL ENHANCEMENTS section.
  565.  
  566. Option #2 will open a window and prompt for a source drive,
  567. destination drive and destination subdirectory.  The source drive
  568. will be prefilled with the drive letter that the install was
  569. started from.  Using this option users will be able to install
  570. from a subdirectory on a hard drive to another.  This is great
  571. for users that will pull your software down from a BBS.  Option
  572. #1 does not allow this.
  573.  
  574. After one of these options has been selected yet another window
  575. will appear asking if an optional confirmation window should
  576. appear.  If selected, a window will appear after the drives and
  577. directory have been selected confirming the choices made.  If the
  578. user declines the choices made, the selection process will begin
  579. again.
  580.  
  581.                          GENERATE DISTRIBUTION DISKS
  582.  
  583. This option will automatically build your distribution disk set. 
  584. You need to first copy the installation programs that you will be
  585. using like INSTALL.EXE, INSTALL.CFG, SETUP.EXE, INSTALL.WIN or
  586. UPDATE.CFG to the first disk.  Then select this option and enter
  587. in the destination drive and the drive and subdirectory where
  588. your files exist.  This will put all the files in the specified
  589. directory onto the floppy drive by size.  The sorting method will
  590. minimize the need for too many disks.  Pressing a key during this
  591. operation will allow you to abort the process.
  592.  
  593.                       LOADING AND SAVING CONFIGURATIONS
  594.  
  595. These options either save the current configuration to a file or
  596. loads a previously saved configuration.  IMPRESSION will
  597. automatically backup the configuration file that you are saving
  598. with the extension of .BK!.  Note that the file used by
  599. INSTALL.EXE is INSTALL.CFG and the final configuration should be
  600. named such.
  601.  
  602.                                 SHELL TO DOS
  603. If the need to exit to DOS without leaving the IMPRESSION program
  604. arises simply select this option and you will shell to DOS.  Type
  605. EXIT and the DOS prompt to return to IMPRESSION.
  606.  
  607.                                THE COMPLETION
  608.  
  609. Upon completing your configuration file, simply copy the
  610. INSTALL.EXE, INSTALL.CFG and file that you created to your own
  611. application disk and you are complete.  The user simply types
  612. A:INSTALL and you have a professional installation with a minimum
  613. amount of work.  Its that easy!  Enjoy.                            INSTALLATION FLOWCHART
  614.  
  615. The following is a step by step preview of what goes on when
  616. INSTALL is executed.
  617.  
  618. 1.    Checks for an UPDATE.CFG file.  If one exists a box appears
  619.       asking the user if they wish to install an update or a full
  620.       installation.  If the update option is selected it will load
  621.       the UPDATE.CFG file, otherwise it will load the INSTALL.CFG
  622.       file.
  623. 2.    Checks for specified items such as DOS version running, math
  624.       coprocessor, base memory and game port.  Depending on the
  625.       options selected in the INSTALLATION ENHANCEMENTS section
  626.       will depend on the course of the installation.
  627. 3.    The greeting window will appear and wait until a user press
  628.       a key to continue.
  629. 4.    The program window will appear along with the DIRECTORY
  630.       INFORMATION screen where the user will enter in the drive
  631.       information.
  632. 5.    If the option for a "confirmation screen" was selected it
  633.       will appear asking if the selected drive specifications are
  634.       correct.  If not it will return to the DIRECTORY INFORMATION
  635.       screen.
  636. 6.    Confirms that the destination drive exists.
  637. 7.    Confirms space exists.
  638. 8.    If the users name is to be hardcoded on the source drive
  639.       that function will be performed at this time.
  640. 9.    Checks if directory already exists?  If not it creates one,
  641.       if so it will query the user if they want to use the
  642.       existing directory.
  643. 10.   Checks to see if first file exists and if so prompt user if
  644.       they want to reinstall.  Otherwise file copying continues.
  645. 11.   If the users name is to be hardcoded on the destination
  646.       drive that function will be performed at this time.
  647. 12.   Executes commands that were entered in the DOS command
  648.       section.
  649. 13.   Prompts user to print documentation.  If Yes INSTALL will
  650.       auto sense the available ports to print to and opens a
  651.       window to select the desired port.
  652. 14.   Prompts user to add directory to PATH statement in the
  653.       AUTOEXEC.BAT file.
  654. 15.   Prompts user to add environment variable to the AUTOEXEC.BAT
  655.       file.
  656. 16.   If either of the above two options have been selected then
  657.       it will modify the AUTOEXEC.BAT file after copying it to a
  658.       file named AUTOEXEC.HLD.  It will also notify the user that
  659.       changes have been made.
  660. 17.   Prompts user to confirm that the number of FILES and BUFFERS
  661.       are where they should.
  662. 18.   Prompts user to add DEVICE DRIVERS to the CONFIG.SYS file.
  663. 19.   If either of the above two options have been selected then
  664.       it will modify the CONFIG.SYS file after it has been copied
  665.       to a file named CONFIG.HLD.  It will also notify the user
  666.       that changes have been made.
  667. 20.   Prompts the user to view any README files.
  668. 21.   If changes were made to the CONFIG.SYS file the user is
  669.       asked if they wish to reboot the machine at this time.  If
  670.       they do it does not return to the INSTALL program.
  671. 22.   At the end of the INSTALL an "exit" program may be specified
  672.       and will be executed.  The user is not returned to the
  673.       INSTALL after leaving the "exit" program specified.                       CUSTOMIZABLE WINDOW INSTALLATION
  674.  
  675.                                   SETUP.EXE
  676. SETUP will allow you to obtain a totally customized install
  677. utilizing many windows and functions.  All window routines are
  678. controlled by the developer except for the File Copy window that
  679. appears during the installation process.  This window is where
  680. all of the actual installation takes place.  All prompting
  681. messages will appear in this window.
  682.  
  683. There can be up to twenty-six (26) windows open at a time.  First
  684. determine the appearance of a window.  Take into consideration
  685. things like size, colors, text and titles and the message you
  686. wish to convey.  The attributes may be changed at any time.  
  687.  
  688. This dialogue for defining and using constructable windows below
  689. will be your guide to creating the ultimate installation.
  690.  
  691.                      FORMAT STYLES FOR WINDOW ROUTINES 
  692.  
  693. CREATING A BACKGROUND
  694.  
  695.       B,░,1,14
  696.  
  697.       B  - Fill screen routine.
  698.       ░  - Character to fill the screen with.
  699.       1  - Background color to use.
  700.       14 - Foreground color to use.
  701.  
  702.       All windows should be closed before calling this routine. 
  703.       It is not fatal but if a window that appears 'behind' the
  704.       new background is closed, the text that appeared below it
  705.       when it was opened will be set over the background and make
  706.       a 'hole' in it.
  707.  
  708.  
  709. OPENING A WINDOW
  710.  
  711.       OC,800,14,40,35,8,7,14,1,14,3,0
  712.  
  713.       OC -  Open window C.  There can be twenty six windows:  A-Z.
  714.       800-  Window Type.  Four Window Types are:
  715.              0 = Normal window.
  716.              500 = Shadowed window.
  717.              800 = Exploding window.
  718.             1000 = Borderless window. 
  719.       14 -  Upper Row.  Rows start with 0. 
  720.       40 -  Left most Column.  Columns start with 0.
  721.  
  722.       (The above two numbers make up the top left corner of the
  723.       window.)
  724.       35 -  Number of column wide.  The left most column and the
  725.             width may be no larger than 80.
  726.        8 -  Number of rows down.  The upper row and length may be
  727.             no larger than 25.
  728.        7 -  Background attribute of the border.
  729.       14 -  Foreground attribute of the border.
  730.        1 -  Background attribute of the window.
  731.       14 -  Foreground attribute of the window.
  732.        3 -  Row of window to put a horizontal bar.
  733.        0 -  Column of window to put a horizontal bar.
  734.  
  735. CLOSE WINDOW
  736.  
  737.       CC
  738.       CC -  Close window C.  Same would be done for other windows.
  739.  
  740. CLEARING A WINDOW
  741.  
  742.       WC
  743.       WC -  Wipe window C.  Be cautious with this because if there
  744.             are bars in the window they will also be cleared out.
  745.  
  746. MOVING BARS AROUND IN A WINDOW
  747.  
  748.       VA,4
  749.       V -   Move a Vertical bar to a new location.
  750.       A -   The window in which to perform the operation.
  751.       4 -   The column to make the bar appear.
  752.  
  753.       HA,4
  754.       H -   Move a Horizontal bar to a new location.
  755.       A -   The window to perform the operation.
  756.       4 -   The row to make the bar appear.
  757.  
  758.       By setting the bar position to 0 it will remove the bar from
  759.       the window selected.
  760.  
  761. SET BORDER CHARACTERS
  762.  
  763.       S3
  764.       S3 -  Sets the border to set number 3.  Valid values are 1-8.
  765.  
  766. MOVE A WINDOW
  767.  
  768.       MC,5,10
  769.       MC -  Move Window C.
  770.        5 -  Row to Move to.
  771.       10 -  Column to move to.
  772.  
  773. PUTTING TEXT IN THE WINDOW
  774.  
  775.       STYLE #1:  CENTERED
  776.  
  777.       LAC,3,Welcome To My Program
  778.       LAC - Line of text in Window A and the C is for Centering
  779.       it.
  780.        3  - Row in window to put the text
  781.       Wel - The text that will go in the window.
  782.  
  783.       STYLE #2:  PLACED AT COL,ROW
  784.  
  785.       LAL,5,10, More words
  786.       LAL - Line of text in window A and the L is for Left justify
  787.       and row,col.
  788.        5 -  Row to put text.
  789.       10 -  Column to put text.
  790.       More - The text to put in window.
  791.  
  792. PUTTING TITLES ON BORDERS
  793.  
  794.       TA,3,MY TITLE
  795.       TA - Put a title in Window A.
  796.        3 - Put title in location 3.  Valid locations are 1-6.
  797.                  1 = Top Right
  798.                  2 = Top Left
  799.                  3 = Top Center
  800.                  4 = Bottom Right
  801.                  5 = Bottom Left
  802.                  6 = Bottom Center
  803.       MY - The text to put in the title.
  804.  
  805. CHANGING THE ATTRIBUTE OF TEXT PUT INTO A WINDOW
  806.  
  807.       AAW,4,14
  808.       AAW   Attribute change in window A and make it effect the
  809.             Window.  The other option would be B in place of W to
  810.             change the subsequent border writes.
  811.        4 - New background color.
  812.       14 - New foreground color.
  813.  
  814.  
  815. PAUSING THE SCREEN ACTIVITY
  816.  
  817.       P5
  818.       P5 -  Pause the screen for 5 seconds (approx).  This
  819.             procedure will pause the screen for the number of
  820.             seconds specified or until a key or mouse button is
  821.             pressed.  Using P1 will basically have no effect.  If
  822.             ESCAPE is pressed the install is aborted.
  823.  
  824. HOW TO START THE INSTALLATION
  825.  
  826.       *
  827.       * -   That's it, just an asterisk (*).  It must be the first
  828.             character on the line.  You may also have more window
  829.             activity after you perform the install.  This will call
  830.             INSTALL.EXE from the drive that the install originated
  831.             on.  
  832.  
  833. The file that needs to be created to use these windows is titled
  834. INSTALL.WIN.  To create the INSTALL.WIN file use a text editor or
  835. word processor that will save ASCII text.  Look at the
  836. INSTALL.WIN file that came with IMPRESSION.  It will show you
  837. many things that can be done with a 'window'.
  838.  
  839. Upon registering First Impression You will also receive an additional
  840. program named CHECKWIN.  After you create the INSTALL.WIN file it 
  841. may be checked for any trouble spots by using this program.  This 
  842. will display any errors found within the window file.  It will display 
  843. the line number and what problem was discovered.  It does not check for
  844. the format of the lines just what you are doing to a window.
  845.  
  846. If this is the way the install is to be performed two extra files
  847. need to be copied to the source disk.  The SETUP.EXE and
  848. INSTALL.WIN files.  Now on the distribution disk you tell the
  849. user to type A:SETUP instead of A:INSTALL.  SETUP.EXE may be
  850. rename if you like but all other files must remain the same.
  851.  
  852.                               UNINSTALL OPTION
  853. INSTALL has an uninstall option.  This is a destructive option. 
  854. To perform and uninstall the user must type INSTALL /U [enter]. 
  855. This will prompt the user twice with "are you sure" questions. 
  856. If either are answered "NO" it will be aborted otherwise it will
  857. erase ALL subdirectories and files from the base directory down. 
  858. This means if the user installed the program in the subdirectory
  859. MYPROG and during the install several other directories were
  860. created for data and other files, MYPROG and the other
  861. directories would be removed.  DO NOT document this option if you
  862. do not want the user to know about it.  Its effects are
  863. permanent, unless you know how to use an undelete program.
  864.                                     INDEX
  865. BACKGROUND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
  866. BASE MEMORY REQUIREMENTS. . . . . . . . . . . . . . . . . . . . . . . . . 6
  867. BATCH FILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  868. BORDER CHARACTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
  869. CHANGING ATTRIBUTES . . . . . . . . . . . . . . . . . . . . . . . . . . .16
  870. CHECKWIN.EXE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
  871. CLEARING A WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
  872. CLOSE WINDOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
  873. COLOR ATTRIBUTES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  874. COMMAND LINE OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  875. CONFIG.SYS UPDATES. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  876. CONFIGURATION FILES
  877.       LOADING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
  878.       SAVING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
  879. COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  880. DEFAULT SUBDIRECTORY. . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  881. DESTINATION SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  882. DISK LABELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  883. DISTRIBUTION DISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  884. DOS INSTRUCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  885. DOS VERSION REQUIREMENTS. . . . . . . . . . . . . . . . . . . . . . . . . 6
  886. FILE COPY WINDOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
  887. FILES, NUMBER OF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  888. GAME PORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  889. GENERATE DISTRIBUTION DISKS . . . . . . . . . . . . . . . . . . . . . . .11
  890. HARDCODING THE USERS NAME . . . . . . . . . . . . . . . . . . . . . . . . 5
  891. INSTALL.WIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
  892. INSTALLATION FLOWCHART. . . . . . . . . . . . . . . . . . . . . . . . . .12
  893. LIABILITY WAIVER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  894. LOCKED SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  895. MATH COPROCESSOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  896. MOUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  897. MOVING A WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
  898. MOVING BARS AROUND IN A WINDOW. . . . . . . . . . . . . . . . . . . . . .15
  899. OMBUDSMAN STATEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  900. OPENING A WINDOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
  901. PAUSING ACTIVITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
  902. REGISTRATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  903. SETUP.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
  904. SHAREWARE STATEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  905. SOUND EFFECTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  906. STARTING THE INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . .16
  907. SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  908. TEXT IN THE WINDOW. . . . . . . . . . . . . . . . . . . . . . . . . . . .15
  909. TITLE LOCATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
  910. TITLES ON BORDERS . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
  911. UNINSTALL OPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
  912. WINDOW BORDERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  913. WINDOW TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  914. WINDOW TYPES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
  915.