home *** CD-ROM | disk | FTP | other *** search
/ Total Meltdown / dukenukemtotalmeltdown.img / install.doc < prev    next >
Text File  |  1994-11-22  |  53KB  |  1,252 lines
  1. Install                                              November 16, 1993
  2.                                                                Page 17
  3.                                    
  4.                        I N S T A L L  3 . 7 1 3
  5.                                    
  6.                            22 November 1994
  7.                                    
  8.                               Mark Wilden
  9.                                    
  10.  
  11.  
  12. This manual describes Install, a program that installs a program on a
  13. user's hard or floppy disk.  Install shows the user the hardware and
  14. software options it thinks are most suitable, asks for his
  15. confirmation of these choices, then runs a script which typically
  16. creates a subdirectory for the game on the user's hard disk and copies
  17. the necessary files to it.
  18.  
  19. This manual is updated regularly and is stored in ASCII format with
  20. the rest of Install, in the X:INSTALL directory.  See the last section
  21. "Changes" for a revision history.
  22.  
  23.  
  24. Starting Install
  25.  
  26. The user starts the Install program by logging onto the disk drive
  27. that contains the Install program and typing INSTALL.  After a pause
  28. to read files from the installation disk, an introductory screen is
  29. displayed.  The user can press ENTER at this screen to continue or ESC
  30. to cancel installation.
  31.  
  32.  
  33. Choosing a Destination Drive
  34.  
  35. The next screen asks the user to select which hard disk to install the
  36. game to only if the install is invoked from drives A:, B: or a CD
  37. drive.  Only drives C: and above are allowed (unless the FLOPPY=YES
  38. option is present in RESOURCE.CFG--see below).  The user can press ESC
  39. to cancel installation at this point, or select a drive with
  40. sufficient space on it.  The amount of space the game takes should be
  41. specified in RESOURCE.CFG with an entry of the form 'space=x' where x
  42. represents the amount of space in K.  If this entry is not present in
  43. RESOURCE.CFG, no space checking is done.
  44.  
  45. If the Install program can determine that a particular drive has been
  46. compressed via Stacker or a similar utility, it will put a '?' beside
  47. that drive if there isn't at least twice the required space available.
  48. This is because our games are already compressed, and disk compression
  49. utilities can't take that into account.
  50.  
  51. The Install program will look on the hard disk specified to see if the
  52. game was previously installed, in which case the user's old choices
  53. will be used on the next screen.
  54.  
  55.  
  56. Confirming Installation Choices
  57.  
  58. The Installation Choices screen shows the user what hardware and
  59. software options it thinks are most suitable for running the game.  At
  60. this point the user can:
  61.  
  62.      Choose "View documention update in README file" (if there is a
  63.           file called README or READ.ME on the installation disk).
  64.      Choose "Make bootable floppy disk" to make a boot disk,
  65.      Choose "Accept these choices" to continue the installation,
  66.      Choose "Cancel installation" to return to DOS,
  67.      Press ESC to return to the previous screen (the destination drive
  68.           choice), or
  69.      Move the highlight to a choice and press ENTER to change it.
  70.  
  71. Changing an Installation Choice
  72.  
  73. If the user wants to change an installation choice, a menu is shown
  74. with the possible choices for that item on it.  In general, the
  75. choices will be listed in decreasing order of desirability.  A check
  76. mark is displayed beside each choice that the Install program has
  77. detected the user's machine can support.
  78.  
  79. The user can put the highlight on a given choice and press F1 to get
  80. help for that choice, if available.  In addition, some choices will
  81. bring up an additional screen of information if the user chooses it.
  82. If the user selects a choice that the program feels is not supported
  83. by his hardware, a warning message is displayed and the user is asked
  84. to confirm his choice.
  85.  
  86.  
  87. Installation Menus
  88.  
  89. Here are the specific installation choice menus for SCI games (TSN may
  90. have different screens).  If there is only one choice possible for a
  91. given type of option, the choice won't be displayed on the
  92. Installation Choices screen (such as the Video choice for a VGA-only
  93. game).  If there are no choices possible (because there are no driver
  94. files for that choice present), no choice will be displayed on the
  95. Installation Choices screen.
  96.  
  97. Video     This menu shows the video card and monitor choices.  The
  98.           Install program can detect what video card the user has, so
  99.           he should rarely have to use this menu to change the default
  100.           video choice.
  101.           
  102. Sound     Here is where the user selects what sound card to use.
  103.           Again, we can usually detect this, with the exception of the
  104.           Game Blaster card.  Also, we consider that the user has a
  105.           Roland card if he has any MIDI device attached.
  106.           
  107. Audio     This menu allows users of CD games to specify the driver to
  108.           use for speech and other CD audio.
  109.           
  110. Joystick  This menu allows the user to specify whether to use his
  111.           joystick or not.  We detect the presence of a joystick.
  112.           
  113. Keyboard  This menu allows the user to specify whether to use an IBM
  114.           or a Tandy keyboard.  We do not detect the Tandy keyboard.
  115.           
  116. Mouse     We detect whether the user has a mouse, but this menu allows
  117.           him to choose not to have the game use it.
  118.           
  119. Memory    This menu lets the user turn off our use of his extra memory
  120.           (expanded, extended, and/or XMS memory) if he has any.
  121.           Pressing F1 at this menu shows the user which of these types
  122.           of extra memory he has, and how much of each is available.
  123.           
  124. Directory This is an input field that allows the user to choose the
  125.           directory where game files will be placed.  The default is
  126.           the value, if any, is listed in the RESOURCE.CFG file. The
  127.           value entered by the user is checked for validity.
  128.           
  129. You can prevent the Mouse and Memory menus from appearing (since they
  130. have no files associated with them) by including lines of the form
  131.  
  132.      mouseDrv = none
  133.  
  134. or
  135.  
  136.      memoryDrv = none
  137.  
  138. in the RESOURCE.CFG that you ship.  This is appropriate for SCI32
  139. games.
  140.  
  141.  
  142. Make Bootable Floppy Disk
  143.  
  144. This procedure formats a boot disk with minimal AUTOEXEC.BAT and
  145. CONFIG.SYS files.  On DOS 5.0 80386 systems, it loads DOS, the mouse
  146. driver and other needed drivers high for real mode games; for SCI32
  147. protected mode games it leaves them in low memory.
  148.  
  149. These are the RESOURCE.CFG entries that indicate the minimal
  150. configuration expected in order to make the boot disk:
  151.  
  152.      minCPU = 386 (only "386" is currently supported)
  153.      minDOS = 500 (or 401 or 330, etc.)
  154.      mode = real (for SCI16 games)
  155.      minEMS = 200 (in kilobytes)
  156.      smartDrv=yes
  157.  
  158. If minEMS is present and mode=real, EMM386 will be directed to provide
  159. EMS memory; otherwise not.
  160.  
  161. In addition, this entry determines whether CD drivers, if found in the
  162. user's boot files, will be added to the boot disk:
  163.  
  164.      CD = yes (or no)
  165.  
  166. If smartDrv=yes entry is found, SmartDrive will be loaded from the
  167. boot disk.  If minEMS is given, SmartDrive is given one third of
  168. available memory; otherwise, it takes it all.
  169.  
  170. The step-by-step procedure follows:
  171.  
  172. The procedure reads the user's current configuration.  If he is not
  173. using a high enough version of DOS or a good enough CPU, it aborts.
  174. If he does not have enough extended memory to provide the minimum
  175. amount of EMS, it aborts.  This must include 200K for the game, 200K
  176. for upper memory blocks, 208K for the observed overhead of
  177. EMM386.EXE/HIMEM.SYS and 50K for slop.
  178.  
  179. If he is running 4DOS or other non-DOS command processor, it aborts.
  180. This is because, under DOS 5.0, the current command processor is
  181. copied during a FORMAT /S, but under the name COMMAND.COM, even if it
  182. was originally named something else.  This can confuse a system like
  183. 4DOS, so we just bag it.
  184.  
  185. The COMSPEC environment variable is used to determine the hard disk in
  186. which to look for stuff like AUTOEXEC.BAT.  If COMSPEC is missing or
  187. doesn't include a drive letter, drive C: is assumed.
  188.  
  189. The user's AUTOEXEC.BAT is read.  If it contains an invocation of a
  190. file with "MOUSE" in the name, that information is recorded.  If it
  191. contains an invocation of SHARE, that information is recorded.  If it
  192. loads MSCDEX (or the MSCDEX replacements CORELCDX or NWCDEX), that
  193. information is recorded and the MSCDEX parameters are parsed to
  194. identify the CD drivers used in CONFIG.SYS.  If it contains a SET
  195. SOUND= or SET BLASTER= command, that information is recorded.  If it
  196. contains a command to run KEYB, that information is recorded.
  197.  
  198. The user's CONFIG.SYS is read.  If it contains an invocation of a file
  199. with "MOUSE" in the name, that information is recorded.  Also recorded
  200. are lines with the following commands:
  201.  
  202.      //  hard disk drivers:
  203.      fixt_drv.sys, dmrvr.bin, edvr.sys, sstor.sys, harddriv.sys,
  204. sswap.com, stacker.com, devswap.com,  sstordrv.sys,
  205.  
  206.      // sound drivers
  207.      mvsound.sys, csp.sys
  208.  
  209.      // CD drivers
  210.      cdrom.sys, chinon01.sys, chinon02.sys, chinon03.sys, fdcd.sys,
  211. mdscd_fd.sys, mtmcdd.sys, mtmcds.sys, neccdr.sys,
  212.      pcds650sm.sys, pcdlat.sys,  sbpcd.sys, sony_cdu.sys,
  213. sony_pfm.sys, tslcdr.sys,
  214.  
  215.      // miscellaneous
  216.      setver.exe
  217.  
  218. The process then searches for the following files:  EMM386.EXE,
  219. HIMEM.SYS and FORMAT.COM.  First the PATH is searched, then the user's
  220. entire hard disk.  If a mouse driver (either MOUSE.COM or MOUSE.SYS)
  221. wasn't found in the user's AUTOEXEC.BAT or CONFIG.SYS, it is also
  222. searched for when the hard disk is searched.  The mouse driver is
  223. optional.  If the minEMS or both the minDOS=500 and minCPU=386
  224. resource file entries were found, EMM386.EXE and HIMEM.SYS are
  225. required.  If they're not found, the process aborts.  For SCI32 games,
  226. these drivers are not required or used.
  227.  
  228. The user is prompted to put a blank disk in drive A:.  The process
  229. checks to make sure the disk is either unformatted, or is a 1.2M,
  230. 1.44M, 720K or 360K floppy disk.  If it can't be determined what size
  231. the disk is, the Install program asks the user.  If the disk contains
  232. INSTALL.EXE, he is prompted to replace it with a disk that doesn't.
  233.  
  234. If any files (including hidden or system files, or directories) are
  235. found on the floppy disk, a list of them is displayed to the user to
  236. confirm that he wants to erase them.
  237.  
  238. The process then runs the DOS FORMAT program.  After this has
  239. finished, it examines the floppy disk to make sure that it includes
  240. three and only three files:  COMMAND.COM and two hidden, system,
  241. readonly files (whose names don't matter).  If not, the format was
  242. assumed to have been unsuccessful and the process aborts.
  243.  
  244. The process then creates AUTOEXEC.BAT on the boot disk.  It contains
  245.  
  246.      @ECHO OFF
  247.  
  248.      C:
  249.  
  250.      PATH <the user's path>
  251.  
  252.      PROMPT <the user's prompt>
  253.  
  254.      SET COMSPEC= <the user's initial comspec>
  255.  
  256.      LOADHIGH <mouse driver>  (if the mouse was loaded in the user's
  257. original AUTOEXEC.BAT or a program that looks like a mouse driver was
  258. found on his hard disk. If the system doesn't support LOADHIGH or if
  259. the game is for SCI32, the mouse is loaded low.)
  260.  
  261.      LOADHIGH MSCDEX <parameters> (if found in user's original
  262. AUTOEXEC.)
  263.  
  264.      MSCDEX <parameters>      It was found that if MSCDEX can't be
  265. loaded high because of insufficient memory, DOS won't load it low as a
  266. fallback.  Therefore, we have to.
  267.  
  268.  
  269. Other commands that were recorded when the user's AUTOEXEC.BAT was
  270. read are added.  If 'directory' and 'cmd' entries are found in
  271. RESOURCE.CFG the process will add commands to change to that directory
  272. and execute that command.  For example, to have the boot disk go into
  273. the \SIERRA\KQ6 directory and run KQ6.BAT, include the following lines
  274. in the RESOURCE.CFG supplied with the game:
  275.  
  276.      directory = \SIERRA\KQ6
  277.      cmd = KQ6
  278.  
  279. Note:  if the user is running INSTALL from his hard disk after a
  280. previous install and makes a boot disk, the directory entry is not
  281. used; the current directory is used instead.  This is to facilitate
  282. things if he copied the game to a different directory after
  283. installation.
  284.  
  285. The process then copies HIMEM.SYS and EMM386.SYS (if needed) to the
  286. boot floppy.  It copies these files instead of just pointing to the
  287. copies on the hard disk to handle the situation if these files are on
  288. a compressed volume and can't be accessed until after the disk
  289. compression software has loaded.
  290.  
  291. The process then creates CONFIG.SYS on the boot disk.  If the game is
  292. not for SCI32 and the user's system supports use of the upper memory
  293. area, it contains
  294.  
  295.      DEVICE=HIMEM.SYS
  296.  
  297.      DEVICE=EMM386.EXE RAM <emsMem> '386 only, where emsMem is the
  298. total amount of extended memory in the user's machine, minus 208K for
  299. observed EMM386.EXE/HIMEM.SYS overhead, minus 100K for slop.  If the
  300. user requires EMS and his boot configuration requires loading other
  301. drivers, such as Stacker or CD-ROM drivers, the parameters "I=C800-
  302. EFFF M3" are added in order to give him enough high memory area.
  303.  
  304.      DOS=HIGH  on a '286 with DOS 5.0, or
  305.  
  306.      DOS=HIGH,UMB on a '386 with DOS 5.0
  307.  
  308. The following entries are also created:
  309.  
  310.      FILES=30
  311.  
  312.      BUFFERS=40
  313.  
  314.      DEVICEHIGH=<mouse driver> if the mouse driver was found
  315.  
  316.      LASTDRIVE=x if found in user's original CONFIG.SYS
  317.  
  318.      DEVICEHIGH=DBLSPACE.SYS /MOVE on DOS 6.0 systems or
  319.      DEVICEHIGH=DRVSPACE.SYS /MOVE on DOS 6.22 systems
  320.  
  321. Other entries, as noted above, are added for sound drivers or disk
  322. managers.
  323.  
  324. Finally, if SHARE was invoked in the user's AUTOEXEC.BAT, he is warned
  325. to reboot after playing the game (since we don't load SHARE)..
  326.  
  327.  
  328. Returning to Default Choices
  329.  
  330. If the user changes any of the choices Install suggested for him when
  331. the game was first installed, an additional choice will be available:
  332. "Return to Sierra defaults."  This lets him start over with a clean
  333. slate.
  334.  
  335.  
  336. Accepting Installation Choices
  337.  
  338. After the user chooses "Accept these choices" from the Installation
  339. Choices screen, he may be shown various information screens, such as a
  340. warning to turn off NUMLOCK before playing the game.  He can either
  341. press ENTER at these screens or ESC to go back and change the
  342. selection.
  343.  
  344.  
  345. Installing the Game
  346.  
  347. At this point, the game is actually installed on the user's hard disk
  348. by executing the installation script in INSTALL.SCR.  This script
  349. usually asks additional questions of the user depending on the
  350. individual game, checks the user's disk for sufficient free space,
  351. creates a subdirectory and copies the game files.  The installation
  352. floppy disk is not modified.  After the script has completed, the user
  353. presses a key to exit Install and proceeds to have fun.
  354.  
  355.  
  356. Installing Without Hardware Autodetection
  357.  
  358. When the Install program starts, it performs various tests to
  359. determine the user's hardware configuration.  It is conceivable that
  360. these tests could hang the user's machine.  In this event, the Install
  361. program can be started with the -m command line flag by typing
  362. INSTALL -m at the DOS prompt.  This flag disables autodetection.  The
  363. user will be presented with a sequence of menus from which to select
  364. his hardware configuration.
  365.  
  366. To enable autodetection selectively, follow the -m flag with a number
  367. specifying the autodetection desired:
  368.  
  369.      VIDEO       1
  370.      MUSIC       2
  371.      VOICE       4
  372.      JOYSTICK    8
  373.      KEYBOARD    16
  374.      COMM        32
  375.      MOUSE       64
  376.      MEMORY      128
  377.  
  378.  
  379. For example, to enable music autodetection only, use INSTALL -m2.  Add
  380. numbers together to enable more than one autodetection.  For example,
  381. to enable memory and video autodetection (128 + 1 = 129) use
  382. INSTALL -m129.  This option is available primarily for debugging
  383. purposes.
  384.  
  385.  
  386. Changing Configuration and Updating a Game
  387.  
  388. If the user needs to change his configuration after installing the
  389. game, he can run the Install program again from his hard drive.  He
  390. will not be asked which drive to install to, and his previous choices
  391. will be displayed for him to change.
  392.  
  393. In the case of updating a game from floppy, after selecting the drive
  394. to install to the old configuration will be presented for the user to
  395. change if necessary.
  396.  
  397.  
  398. Required Files
  399.  
  400. A typical game will require many different files, which are used
  401. during the installation process by INSTALL.SCR.  These will be
  402. resources, patches, batch files, etc.
  403.  
  404. The files required by the Install program itself are:
  405.  
  406. INSTALL.EXE    The program.
  407.                
  408. INSTALL.HLP    Besides help and information messages, this file also
  409.                contains the names of the driver files that are
  410.                displayed as menu choices.  The order of these entries
  411.                in the file determines the order of the menu choices.
  412.                
  413. INSTALL.TXT    This file contains the rest of the text displayed by
  414.                the program.  If either this file or INSTALL.HLP is not
  415.                found on the current drive, the Install program won't
  416.                be able to locate its text, and an error message will
  417.                be displayed.
  418.                
  419. INSTALL.SCR    This file contains the commands to actually copy a game
  420.                to a user's disk.  The Install program will run without
  421.                this file, but there wouldn't be much point.
  422.                
  423. The following is information of interest mainly to programmers.
  424.  
  425.  
  426. Menu Choices
  427.  
  428. Menus in general are created from the driver files found on the
  429. installation disk.  If there are no driver files of a given menu's
  430. type on disk (like CD speech, for example), no menu will be displayed
  431. and no choice will be recorded in RESOURCE.CFG.  If there is only one
  432. driver file (e.g. VGA320.DRV for a VGA-only game), the menu won't be
  433. displayed and that driver will be recorded in RESOURCE.CFG
  434. automatically.
  435.  
  436. The order of driver menu choices is determined by the order of the
  437. corresponding text entries in INSTALL.HLP.
  438.  
  439.  
  440. Help, Information and Warnings
  441.  
  442. There can be help and/or information for each menu choice.  A help
  443. entry is displayed when the user highlights the choice and presses F1.
  444.  
  445. An information entry is displayed when the user selects a choice by
  446. pressing ENTER on it.  In general, an information item is provided to
  447. warn the user of some condition (e.g. to turn off NUMLOCK in order to
  448. control Ego with the keypad cursor keys).  When the information is
  449. displayed, the user has the option of pressing ENTER to continue, or
  450. ESC to go back and change his choice.
  451.  
  452. If the user doesn't go to any of the individual menus to change the
  453. default choices, all appropriate information screens will be shown
  454. when he accepts the choices shown on the Installation Choices menu.
  455. This makes sure he sees all warnings.
  456.  
  457. There doesn't have to be help or information entries for all menu
  458. choices, though naturally help entries are desirable.
  459.  
  460.  
  461. Input Fields
  462.  
  463. TSN Install contains some screens that are input fields instead of
  464. menus.  Install will record the contents of these fields in the
  465. configuration file entry, rather than the name of a driver file.
  466.  
  467.  
  468. Viewing README
  469.  
  470. If a file by the name README or READ.ME is present, the user can view
  471. it from within the Install program.  The file should be formatted so
  472. that no lines are longer than 74 characters.  Tabs are not expanded.
  473.  
  474.  
  475. Text Files
  476.  
  477. Install stores all of the text it displays in the text files
  478. INSTALL.HLP and INSTALL.TXT, which must be included on the
  479. installation disk.  INSTALL.HLP contains help and information;
  480. INSTALL.TXT contains all the rest of the text displayed by the
  481. program.  These files have the format
  482.  
  483.      \\label
  484.      text
  485.      \\label
  486.      text
  487.      [etc...]
  488.  
  489. where label is an identifying string, and text is the actual
  490. information.  Case is not significant in label.  Whitespace after the
  491. backslashes and after the label is stripped, but whitespace within the
  492. label is significant.  Text can be as many lines as necessary.  Each
  493. line can be up to 2000 characters long and will normally be
  494. wordwrapped if necessary when displayed by the program.  A single line
  495. can be broken into separate lines if each line ends in a backslash.
  496. The backslash and newline will be deleted when read.
  497.  
  498. At startup, Install scans the installation disk for INSTALL.TXT and
  499. INSTALL.HLP, then for any other .TXT and .HLP files and adds their
  500. contents to its dictionary of text entries.  An entry for a given
  501. label overrides a previously defined entry.  Therefore, if you want to
  502. override an entry without changing the default files, simply include
  503. another .TXT or .HLP file with the new entries.
  504.  
  505. The labels for help, information and driver descriptions are of the
  506. form driver.hlp, driver.inf and driver.drv respectively, where driver
  507. represents the base name of the associated driver file or choice.  The
  508. description of the driver used as the text for a menu choice is no
  509. longer taken from the driver file itself but comes from the text file
  510. INSTALL.HLP.
  511.  
  512.  
  513. Configuration File
  514.  
  515. When the user chooses to accept the configuration on the Installation
  516. Choices menu, the choices are recorded in the RESOURCE.CFG file.  For
  517. each item, a line is recorded in this file showing the driver chosen.
  518. For example, the Video menu will create a line like
  519. videoDrv = VGA320.DRV.
  520.  
  521. Three menus act a little differently:  The Joystick menu will record
  522. either joyDrv = JOYSTICK.DRV or joyDrv = NO.  The Mouse menu will
  523. record either mouseDrv = STDMOUSE.DRV or mouseDrv = NO.  The Memory
  524. menu will record either memoryDrv = ARM.DRV or memoryDrv = NO.  Note
  525. that there are no driver files called STDMOUSE.DRV, ARM.DRV or NO.
  526.  
  527.  
  528. Forcing Full Install
  529.  
  530. The Install program only runs the Install script (which does all the
  531. file copying) if the user is running it from floppy drive A: or B: or
  532. from a CD drive.  Otherwise, it assumes the user is updating a prior
  533. installation and simply updates his RESOURCE.CFG.
  534.  
  535. To force the Install program to do a full install and run the Install
  536. script, use the -f option on the command line.
  537.  
  538.  
  539.  
  540. SIP Compression
  541.  
  542. SIP compression is the scheme by which the install program can utilize
  543. file compression in order to cut down on the amount of floppy disk
  544. space needed to install a game.  The files to be compressed can be
  545. files internal to the install such as install.txt,  as well as other
  546. files that are eventually copied over to the user's hard disk during
  547. install  process.
  548.  
  549. The nice thing about this compression feature is that it is completely
  550. optional.  Anyone not interested in the benefits of modern data
  551. compression can operate the  install program in the normal fashion.
  552. The basis from which  the install can make use of compression is the
  553. presence of SIP archive files (name.sip).  These SIP files are simple
  554. archives created by the command-line tool sip.exe,  which uses the
  555. PKWare data compression library to perform the actual compression.
  556. More information about the tool "sip.exe" can be obtained from the
  557. document "sip.doc" available at an  X: near you.
  558.  
  559. Install recognizes "install.sip" to be the SIP file that contains the
  560. following
  561.  
  562. files:
  563.  
  564.    install.txt
  565.  
  566.    install.scr
  567.  
  568.    install.hlp
  569.  
  570.    readme or read.me
  571.  
  572.    resource.cfg
  573.  
  574. If this file is present the install will obtain these files from the
  575. archive, thus the first three must be present within the archive while
  576. the last two are optional as the norm.  Another SIP file that can be
  577. used is "drivers.sip" that contains all of the drivers used by the
  578. install for detection purposes and  subsequently copied over to the
  579. hard disk.  The file "sierra.sip" is recognized as well,  for it can
  580. contain any miscellaneous files like patches or map files that
  581. eventually get copied over by the install script.
  582.  
  583. The mere presence of any one of these SIP files will trigger  its use
  584. by the install program.  For example, if archive "drivers.sip" resides
  585. on the source disk, the install will process drivers using the
  586. archive.  If "drivers.sip" is not present, the install will expect the
  587. driver files to be on the diskette in uncompressed form.  The same
  588. thing applies for "install.sip".
  589.  
  590. The install script requires no special commands to copy over files
  591. included within an SIP file because the Copy command has been modified
  592. to search the relevant SIP files for the file or files to be copied.
  593. If a match is found, the file is then automatically extracted to the
  594. destination disk along with a message
  595.  
  596. indicating said extraction.  For example, the script command "Copy
  597. *.bat" would extract all batch files included within any of the
  598. SIParchives, then any remaining loose batch files would be copied over
  599. if present.  As of now, there is no SIP support for the operation of
  600. copying files kept  over several disks.  This operation, if needed,
  601. will have to use standard uncompressed files.
  602.  
  603. Since it is the install script's responsibility to copy over all of
  604. the files normally included within the SIParchives, the re-install
  605. process has no need for the original SIP files.  The re-install merely
  606. proceeds with the loose files already present on the hard disk.
  607.  
  608. The only difference perceived by the user will be that the install's
  609. initialization before the first screen appears will take a bit longer.
  610. This will only be a factor during the initial install from floppies.
  611. As for the game team, the compression process will require a small
  612. amount of effort to create and maintain the SIP archives, but the less
  613. cluttered setup disk should prove to be  a welcome addition to any set
  614. of volumes.
  615.  
  616.  
  617. Command Script Language
  618.  
  619. If the user is running the Install program from a floppy drive (A: or
  620. B:) or a CD drive and the installation script file INSTALL.SCR is
  621. present, it will be executed.  INSTALL.SCR uses a language very
  622. similar to MS-DOS Batch, but with enhancements.  Typically, the
  623. installation script will display messages to the user, get input from
  624. him, check for sufficient disk space, create a subdirectory and copy
  625. files.
  626.  
  627. Three variables are passed to the script by the Install program:
  628.  
  629.      %1, which is replaced by the destination drive
  630.      %2, which is replaced by the installation source drive
  631.      %3, which is replaced by the new contents of RESOURCE.CFG
  632.      %4, which is replaced by the destination directory
  633.  
  634. The trailing colon is not included in the drive parameters--you must
  635. supply it when you use the parameter in the script file.
  636.  
  637. If the user is installing from floppy disk or CD (as opposed to a
  638. reinstall from the hard disk in order to change options), it is the
  639. responsibility of the script file to create RESOURCE.CFG in the
  640. appropriate directory on the user's hard disk.  It can't simply be
  641. copied from the floppy disk, since it isn't written there.  The
  642. following command is necessary to create RESOURCE.CFG
  643.  
  644.      echo %3>resource.cfg
  645.  
  646. and should be included in the section of the script file where other
  647. files are copied from the floppy disk to the user's hard disk.  This
  648. approach eliminates writing to the floppy disk, which users object to,
  649. and also conforms to situations where the installation disk can't be
  650. written to, like CD-ROM products.
  651.  
  652.  
  653. Sample Installation Script
  654.  
  655. Following is a sample INSTALL.SCR with annotations.  It is intended
  656. for tutorial purposes only; the actual script will be dictated by your
  657. game's needs.
  658.  
  659. godir %1:%4    CantCreate
  660.      godir creates the directory specified and changes to it (going to
  661.      the CantCreate label if the directory can't be created or changed
  662.      to).
  663. echo Copying Startup Files ...
  664.      This section will differ depending on the game, but note the
  665.      creation of RESOURCE.CFG.
  666. copy %2:*.drv
  667. copy %2:*.hlp
  668. copy %2:*.txt
  669.      Make sure you copy all the .TXT and .HLP files to the hard disk,
  670.      or else the user won't be able to run the install program again
  671.      from there.
  672. copy %2:version
  673. copy %2:sierra.exe
  674. copy %2:resource.000
  675. copy %2:resource.map
  676. echo %3 > resource.cfg
  677.  
  678. copy %2:install.exe
  679.  
  680. echo Copying Game files...
  681.      These lines copy the resource files from each disk to the hard
  682.      disk, checking to see if the file exists in the source floppy
  683.      drive before prompting the user to insert it.
  684. exists %2:resource.001 Insert Disk 1 in drive %2:.
  685. copy %2:resource.001
  686. exists %2:resource.002 Insert Disk 2 in drive %2:.
  687. copy %2:resource.002
  688. exists %2:resource.003 Insert Disk 3 in drive %2:.
  689. copy %2:resource.003
  690. exists %2:resource.004 Insert Disk 4 in drive %2:.
  691. copy %2:resource.004
  692. exists %2:resource.005 Insert Disk 5 in drive %2:.
  693. copy %2:resource.005
  694.  
  695. :exit
  696. clear
  697. echo
  698. echo  To play NOW:
  699. echo     Type SQ4 [ENTER].
  700. echo
  701. echo  To play LATER:
  702. echo     Type CD %4 and press [ENTER]
  703. echo     Then type SQ4 and press [ENTER].
  704. echo
  705. pause
  706. end
  707.  
  708. :CantCreate
  709. alert Unable to create directory %1:\sierra\sq4
  710. end
  711.  
  712.  
  713.  
  714. Script Command Reference
  715.  
  716. The commands available in this language are:
  717.  
  718.  
  719. ALERT message
  720.  
  721.      Opens an alert window, displays message, and allows the user to
  722.      press ENTER to continue, or ESC to exit Install.
  723.      
  724.  
  725. CLEAR
  726. CLS
  727.  
  728.      Clears the message window.
  729.      
  730.  
  731. COPY sourceSpec [destSpec] [/q] [/s]
  732.  
  733.      Copies a file or group of files.  Wildcards are permitted.  If no
  734.      destSpec is supplied, copies to the current directory, which is
  735.      usually the destination of the install, following a GODIR
  736.      command.  If the /q flag is present error messages if a file is
  737.      not found will be suppressed.  The /s flag says not to display a
  738.      message while the file is being copied.
  739.      
  740.  
  741. COPY destFileName + sourceFileName
  742.  
  743.      This form allows concatenation of one file to another.  The
  744.      syntax is based on the DOS syntax for the same action.
  745.      destFileName is created if it doesn't exist, and sourceFileName
  746.      is appended to it.  Wildcards are not permitted.
  747.      
  748.  
  749. DEL fileSpec
  750.  
  751.      Deletes a file or group of files.  Wildcards are permitted.
  752.      
  753.  
  754. ECHO text [> or >> file]
  755.  
  756.      With no redirection (> or >>) this command displays text to the
  757.      user.  The redirection symbols allow writing or appending text to
  758.      a file.  This is needed to create the batch file that runs the
  759.      game, since this batch file should include a command to change to
  760.      the correct drive.
  761.      
  762.  
  763. END
  764.  
  765.      Ends the script.
  766.      
  767.  
  768. EXISTS fileName alertMessage
  769.  
  770.      If filename doesn't exist, does an ALERT with alertMessage,
  771.      allowing the user to either put in the correct disk or exit
  772.      Install.
  773.      
  774.  
  775. GODIR path label
  776.  
  777.      Attempts to change directory to path, creating path if necessary.
  778.      If unsuccessful, goes to label.
  779.      
  780.  
  781. GOTO label
  782.  
  783.      Considered harmful (just kidding).
  784.      
  785.  
  786. IF [NOT] ERRORLEVEL value command
  787.  
  788.      Compares the number value to the return value of the last program
  789.      executed.  If the return value was greater than or equal to
  790.      value, command is executed.  NOT reverses this logic.  command
  791.      can be any valid script command.
  792.      
  793.  
  794. IF [NOT] EXIST fileSpec command
  795.  
  796.      Determines if fileSpec (which can be a wildcard) exists and
  797.      executes command if it does.  NOT reverses this logic.  command
  798.      can be any valid script command.
  799.      
  800.  
  801. PAUSE [message]
  802.  
  803.      If message is not specified, Press a key to continue... is
  804.      displayed.
  805.      
  806.  
  807. PICK letters choice1 choice2 choice3 choice4
  808.  
  809.      Gets a keypress from the user, and branches to the appropriate
  810.      choice.  For example, if the command was
  811.           PICK abcd aChoice bChoice cChoice dChoice
  812.      and the user typed a C, the script would goto the label cChoice.
  813.      Case is not significant for keypresses.
  814.      
  815.  
  816. SPACE drive kilobytes label
  817.  
  818.      Tests that drive has kilobytes free; if not, goes to label.  This
  819.      command is not  supported if a "space=x" entry is included in
  820.      RESOURCE.CFG (where 'x' represents the disk space required by the
  821.      game in K) as the Install program itself will test disk space
  822.      requirements.
  823.      
  824.  
  825. TESTDIR path
  826.  
  827.      Tests to see if path contains any files (like those from a
  828.      previous install).  If so, confirms that user wants to continue
  829.      installation.
  830.      
  831.  
  832. Labels
  833.  
  834. The GODIR, GOTO, PICK, and SPACE commands can cause execution to
  835. branch to a label.  As in DOS Batch, a label is a word on a line by
  836. itself with a colon in front of it.
  837.  
  838.  
  839. Running External Programs
  840.  
  841. The installation script can run external programs by simply using its
  842. name, followed by any parameters (including %1, %2 or %3 that Install
  843. provides).  The program name does not have to include an extension,
  844. and if no path is included in the name, the PATH environment variable
  845. will be used to find the program.
  846.  
  847. If the program is a .COM or .EXE file, it is run directly by the
  848. Install program and ERRORLEVEL will be set (see above under the IF
  849. command to see how ERRORLEVEL is used).  If the program can't be found
  850. (for example, if the command is a .BAT file or internal DOS command),
  851. COMMAND.COM is called to attempt to run it and ERRORLEVEL will be set
  852. to -1.  Because of this, there is no error message if a program can't
  853. be found, since COMMAND.COM doesn't tell us.
  854.  
  855. If the output of a program is redirected with > or >>, the screen will
  856. not be cleared.
  857.  
  858.  
  859. Default Configuration File
  860.  
  861. A default configuration file should be included on the installation
  862. disk.  This file can include default entries, no-default entries, a
  863. directory entry, a floppy entry and/or other game-specific constant
  864. information.
  865.  
  866. There can be constant information in the default configuration file
  867. that the Install program doesn't change, use or even know about.  One
  868. such entry is minHunk = 1000k (e.g.).  Install will simply add any
  869. entries it doesn't understand to the installed configuration file.
  870. Install also adds any default, no-default and directory entries to the
  871. installed configuration file.
  872.  
  873. Much of the following applies only to TSN.
  874.  
  875. For most of the choices in the Install program, autodetection provides
  876. appropriate defaults.  But for TSN, e.g., the choice of a default
  877. modem prefix string can be specified by a line in the default
  878. configuration file of the form default prefix = ATZ~!.  ATZ~! will be
  879. the default prefix the user sees when he first installs TSN.  He can
  880. also revert to that prefix by selecting "Return to Sierra defaults"
  881. from the Installation Choices screen.  Default entries are not
  882. currently needed for other Sierra games.
  883.  
  884. It can sometimes be necessary to require the user to make a decision,
  885. rather than simply giving him a default choice.  This can be effected
  886. by including a line in the default configuration file of the form
  887. default touchtone = none (for the touchtone choice).  This ensures
  888. that the touchtone choice menu will be displayed to the user when he
  889. runs the Install program.  Anytime it is necessary to force the user
  890. to make an explicit choice a no-default entry should be included in
  891. the default configuration file.
  892.  
  893. When updating a game from an update floppy (as is done for TSN) it is
  894. desirable to show the user his previous choices.  To do this, a line
  895. of the form directory = \tsn should be included in the default
  896. configuration file.  This would instruct the Install program to look
  897. in the \tsn directory for a previous configuration file.
  898.  
  899. Normally, Sierra games can't be installed to a floppy drive, and the
  900. Install program won't allow drives A: or B: to be selected as the
  901. destination of the install.  However, including the line floppy = yes
  902. in the default configuration file will allow installation to a floppy.
  903. If the destination floppy drive is the same as the installation drive,
  904. the installation script won't be executed; only the configuration file
  905. will be written.
  906.  
  907.  
  908. Password Screen (TSN only)
  909.  
  910. A file called PASS_SET.DTA is maintained.  It can contain three types
  911. of password information:  1) "AB" followed by a password, if the user
  912. chooses automatic password entry; 2) "BC" followed by padding if the
  913. user chooses to enter his password each time and hasn't run the game
  914. yet; or 3) "DF" followed by padding if the user chooses to enter each
  915. time and has run the game.  The password is from 6 to ten uppercase
  916. characters or digits and is encrypted.  The file is padded out to
  917. twelve characters.
  918.  
  919. The directory entry in the configuration file is used to find the
  920. password file on an update.  Otherwise, it is looked for in the
  921. current directory.  The file is always written back out by the program
  922. (not by the script).
  923.  
  924.  
  925. Changes History
  926.  
  927. 3.713            11/22/94  Allow loading SmartDrive in boot disk.
  928.                  
  929. 3.690            7/20/94   Use new names for compression files in DOS
  930.                  6.22.
  931.                  
  932. 3.680            4/5/94    Recognize MSCDEX replacements NWCDEX and
  933.                  CORELCDX.
  934.                  
  935. 3.670            11/21/93  Detect SADL.DRV (Ed Critchlow).
  936.                  
  937. 3.661            11/16/93  Copy over CSP.SYS.  Don't load MSCDEX twice
  938.                  unless one of them is loaded high.
  939.                  
  940. 3.660            11/14/93  Boot disk maker:  SCI32 protected mode boot
  941.                  disk (doesn't load things high).  Copies SET BLASTER=
  942.                  line.  Doesn't abort if can't find DBLSPACE.DRV.
  943.                  Doesn't use "I=C800-EFFF M3" option to EMM386.
  944.                  Prompt puts our text on line above prompt.
  945.                  
  946.                  Other changes:  Fixed SPACE command in script language to treat
  947.                  argument as unsigned.  Added "mode=" line to
  948.                  RESOURCE.CFG to use for real mode (SCI16) programs
  949.                  (for bootdisk maker's benefit).  Better handling of
  950.                  nonexistent or empty drives in drive selection list.
  951.                  
  952. 3.648            5/21/93   Boot disk maker:  Make boot disk
  953.                  AUTOEXEC.BAT go to install destination hard disk,
  954.                  instead of COMSPEC disk.  Pause after running FORMAT
  955.                  so user can view FORMAT error messages, if any.
  956.                  
  957. 3.647            5/13/93   Boot disk maker: fixed FORMAT command
  958.                  invocation for DOS 3.3.
  959.                  
  960. 3.645-6          5/10/93   Boot disk maker:  load mouse driver first.
  961.                  
  962. 3.644            4/26/93   Handle checking for disk compression on a
  963.                  write-protected drive.  If no space on drive to test,
  964.                  or if file error, report no compression.  Boot disk
  965.                  maker:  Support DOS 6's DoubleSpace disk compression.
  966.                  Load mouse driver last.  Fixed bug if MSCDEX is
  967.                  loaded but no CD driver is.
  968.                  
  969. 3.630            3/25/93   Detect Aria sound driver (Ed Critchlow).
  970.                  
  971. 3.620            3/8/93    Source directory wasn't being set properly.
  972.                  Allow SPACE script command if RESOURCE.CFG doesn't
  973.                  contain a "space=" entry.  "directory=" entry was
  974.                  being written twice to RESOURCE.CFG.
  975.                  
  976. 3.612            2/25/93   Boot disk maker allows changing to a
  977.                  directory on boot even if a command isn't specified,
  978.                  and vice versa.
  979.                  
  980. 3.611            2/23/93   Fixed bug in user defined directory screen
  981.                  where the prompt was not adjusted when the
  982.                  destination drive has been changed.
  983.                  
  984. 3.610            2/22/93   Drive selection screen.
  985.                  
  986. 3.600            2/16/93   Added the ability for the install to
  987.                  operating using files compressed using the SIP
  988.                  archive format.  The install can also work as normal
  989.                  without any compression at all.
  990.                  
  991. 3.590            2/5/93    If MSCDEX specifies more than one CD drive,
  992.                  both will be looked for in the user's CONFIG.SYS and
  993.                  used in the boot disk.  If KEYB is used in user's
  994.                  AUTOEXEC.BAT, it will be used in the boot disk.
  995.                  Fixed bug where 64K EMS was eaten each time program
  996.                  was run.
  997.                  
  998. 3.580            1/12/93   The prompt for the user chosen directory
  999.                  now includes the slash built into the prompt.  The
  1000.                  user no longer has to provide it.
  1001.                  
  1002.                       The rest of the changes were for the boot disk
  1003.                  maker:  Memory managed boot file lines are detected.
  1004.                  Added improved CD device driver recognition.  Low
  1005.                  density disk can be formatted in high density drive.
  1006.                  EMM386 and HIMEM.SYS now copied to boot disk for
  1007.                  compatibility with compressed hard drives.   CD
  1008.                  drivers are not loaded unless 'CD=yes' appears in
  1009.                  RESOURCE.CFG.  If the game does not require EMS
  1010.                  (indicated by lack of 'minEMS=' line in RESOURCE.CFG)
  1011.                  the boot disk maker won't direct EMM386 to provide
  1012.                  EMS. If the game requires EMS and a CD driver or hard
  1013.                  disk manager is loading (requiring more high memory),
  1014.                  EMM386  will be run with the I=C800-EFFF M3 option.
  1015.                  Lines in AUTOEXEC preceded with '@' are now processed
  1016.                  correctly.  MSCDEX, if found, is loaded twice:  once
  1017.                  high and once low.  This is because if it fails to
  1018.                  load high because of insufficient memory, it won't
  1019.                  load low unless we explicitly tell it to.  Program
  1020.                  now searches entire floppy disk to make sure the disk
  1021.                  with Install is or isn't in the drive.  After boot
  1022.                  disk is made, changes back to install directory on
  1023.                  floppy.  This allows the boot disk maker to work
  1024.                  properly if Install is                 not run from
  1025.                  the root directory of the floppy.
  1026.                  
  1027. 3.570            12/17/92  Return an errorlevel from external programs
  1028.                  even if output is redirected (we handle all
  1029.                  redirection of output now).  Made tab character a
  1030.                  delimiter when parsing tokens from script.
  1031.                  
  1032. 3.568            11/24/92  Added support for midnone.drv.
  1033.                  
  1034. 3.567            10/1/92   Install will now detect if you are on a CD
  1035.                  drive.  Added support for the Microsoft Windows sound
  1036.                  card.
  1037.                  
  1038. 3.566            9/29/92   Updated copyright notice.
  1039.                  
  1040. 3.565            9/27/92   Fixed a bug so disk errors like disengaging
  1041.                  a floppy too early will be correctly reported.
  1042.                  
  1043. 3.564            9/15/92   For the moment, the install will not append
  1044.                  the 220 usually included on the config file line to
  1045.                  indicate the audio port.  A more complete solution is
  1046.                  forthcoming.
  1047.                  
  1048. 3.563            9/2/92    Added the /s flag to the copy command. This
  1049.                  performs a copy with echoing to the screen.  Fixed
  1050.                  the 'if exist' command to now work properly.
  1051.                  
  1052. 3.562            7/23/92   Program now allows user to pick the
  1053.                  directory where game files will be placed.  Also
  1054.                  added support for the Sound Blaster Pro driver.
  1055.                  
  1056. 3.561            6/15/92   After creating boot disk, prompt to replace
  1057.                  boot disk with install disk after prompting to label
  1058.                  boot disk.
  1059.                  
  1060. 3.560            6/12/92   After making a boot disk, program asks user
  1061.                  to put Install disk back in.  Corrected Gameblaster
  1062.                  and SoundBlaster number of voices information in
  1063.                  INSTALL.HLP.  Changed help and menu text for EGA640
  1064.                  driver so that it doesn't say RGB monitors are
  1065.                  supported (Dan Foy).
  1066.                  
  1067. 3.551            6/10/92   Added several more device drivers to be
  1068.                  copied when making a boot disk.
  1069.                  
  1070. 3.550a           6/8/92    (TSN) TSN.CFG wasn't being written on a
  1071.                  reinstall.
  1072.                  
  1073. 3.550            5/27/92   Support more drivers when creating boot
  1074.                  disk.
  1075.                  
  1076. 3.540            5/26/92   Making a boot disk on a '286 with DOS 5.0
  1077.                  will load DOS high.
  1078.                  
  1079. 3.531            5/15/92   Boot disk making function can start game if
  1080.                  directory and startup command provided in
  1081.                  RESOURCE.CFG.  (Version number wasn't incremented.)
  1082.                  
  1083.  
  1084.  
  1085. 3.531a           5/14/92   (TSN) Always write out the password file,
  1086.                  instead of having the script do it on an initial
  1087.                  install.
  1088.                  
  1089. 3.531            5/13/92   Fixed bug in 'xxx = none' which made
  1090.                  program think 'no' == 'none'.
  1091.                  
  1092. 3.530            5/4/92    Added support for 'xxx = none' resource
  1093.                  file entry so Dynamix can avoid showing the mouse and
  1094.                  memory menus.
  1095.                  
  1096. 3.521            4/30/92   Made so "Make boot disk" is never default
  1097.                  choice.
  1098.                  
  1099. 3.520            4/27/92   Added 'if exist'.
  1100.                  
  1101. 3.511            4/24/92   Fixed another bug where previous install's
  1102.                  config files weren't read properly.
  1103.                  
  1104. 3.510            4/24/92   Added concatenation capability to copy
  1105.                  command.
  1106.                  
  1107. 3.501            4/24/92   Fixed bug where previous install's config
  1108.                  files weren't read properly.
  1109.                  
  1110. 3.500            4/22/92   Added boot disk making function for all
  1111.                  versions of DOS and all CPUs.
  1112.                  
  1113. 3.411a           4/21/92   Added password screens for TSN.
  1114.                  
  1115. 3.411            3/24/92   Found and worked around bug in Borland C++
  1116.                  in boot disk making module.  Added option in code not
  1117.                  to allow making boot disk, for TSN.
  1118.                  
  1119. 3.410            3/20/92   Added DOS 5.0, '386 boot disk making
  1120.                  function.  Fixed some bugs related to faulty
  1121.                  optimization in Borland C++ 3.0.
  1122.                  
  1123. 3.400            3/5/92    Converted to Borland C++ 3.0.  Fixed bug
  1124.                  where shelling to a program in the install script
  1125.                  cleared the screen regardless of presence of
  1126.                  indirection.
  1127.                  
  1128. 3.396c           1/30/92   (TSN only)  Forwent secondary phone number
  1129.                  for this version.
  1130.                  
  1131. 3.396b           1/28/92   (TSN only)  Added secondary phone number
  1132.                  and mailbox number screens.
  1133.                  
  1134. 3.396            1/13/92   Fixed bug where shelling to a program in
  1135.                  the install script truncated the command line after
  1136.                  the first argument.
  1137.                  
  1138. 3.395a           12/19/91  (TSN only)  Made modem setup string input
  1139.                  field wider (from 35 to 55 chars).
  1140.                  
  1141. 3.395            11/21/91  If installing on a network, limit max drive
  1142.                  to install to to Z:.
  1143.                  
  1144. 3.394            11/14/91  Improved detection of Sound Blaster on fast
  1145.                  machines (Chris Smith).
  1146.                  
  1147. 3.393            11/5/91   Fixed bug when a version number was long,
  1148.                  like 3.393a.  Changed title of TSN phone list window
  1149.                  and allowed wider entries.
  1150.                  
  1151. 3.392            11/1/91   Added /q flag to copy command.
  1152.                  
  1153. 3.391            10/14/91  Fixed compiler option that was incompatible
  1154.                  with library.
  1155.                  
  1156. 3.39             10/8/91   Minor internal changes to support The
  1157.                  Laffer Utilities.  Integrated with library used in
  1158.                  other programs (like View Editor).
  1159.                  
  1160. 3.381            10/1/91   (TSN only) Added 9600 baud menu choice.
  1161.                  
  1162. 3.38             9/26/91   Added screen at end of install telling user
  1163.                  to send in his warranty card.
  1164.                  
  1165. 3.371            9/26/91   Sound and speech choices weren't showing
  1166.                  the user's previous choices on a re-install.  Dan Foy
  1167.                  fixed a bug in detection of a Tandy w/VGA.  Increased
  1168.                  size of version number.  Thousandths will be used for
  1169.                  bug fixes; hundredths for small improvements; tenths
  1170.                  for major improvements; and unit for rewrites.
  1171.                  
  1172. 3.37             9/6/91    Fixed YATB (Yet Another Tandy Bug) where
  1173.                  the Tandy would hang while detecting extended memory
  1174.                  if there is none.
  1175.                  
  1176.                  Made right window shadow narrower if in greater than
  1177.                  25-line mode to match size of bottom shadow.
  1178.                  
  1179.                  If an external command is redirected, don't clear
  1180.                  screen.
  1181.                  
  1182. 3.36             9/4/91    Help for TSN phone number views a file
  1183.                  containing phone numbers.
  1184.                  
  1185. 3.35             8/29/91   Wasn't getting text for joystick menu label
  1186.                  from INSTALL.HLP.
  1187.                  
  1188. 3.34             8/28/91   Fixed video display routines to be
  1189.                  compatible with UltraVision.
  1190.                  
  1191. 3.33             8/20/91   Clear screen on abort from critical error.
  1192.                  
  1193. 3.32             8/19/91   Added ability to execute external programs
  1194.                  and test their return value with new IF ERRORLEVEL
  1195.                  command.
  1196.                  
  1197.                       Fixed bug where port wasn't appended to sound
  1198.                  and audio configuration lines.
  1199.                  
  1200. 3.31             8/2/91    Made command log window larger.
  1201.                  
  1202. 3.30             7/31/91   Major rewrite of display and window
  1203.                  handling routines.  The display speed is considerably
  1204.                  faster.  A few windows use different colors.
  1205.                  Converted to large memory model, which has made the
  1206.                  program bigger.
  1207.                  
  1208. 3.22             7/17/91   Improved error message when a text entry
  1209.                  isn't found.
  1210.                  
  1211. 3.21a            7/17/91   (TSN only) New comm port detection.
  1212.                  
  1213. 3.21             7/16/91   Added option to view README file.
  1214.                  
  1215.                       When checking for extended memory capability and
  1216.                  0 is reported free, see if someone else might be
  1217.                  using it; otherwise, say the user doesn't have
  1218.                  extended memory capability.  Takes care of cosmetic
  1219.                  problem where a '286 with no extended memory allows
  1220.                  user to "use extra memory" (even though the game
  1221.                  would not actually try to use it).
  1222.                  
  1223. 3.20             7/15/91   Converted to acompact model to make more
  1224.                  memory available.  This increased the size of the
  1225.                  program by about 11,500 bytes.
  1226.                  
  1227. 3.15                  Fixed bug where a Tandy with no extended memory
  1228.                  could report a bogus amount.
  1229.                  
  1230. 3.14                  Fixed bug where a file created by redirection
  1231.                  could be read-only.
  1232.                  
  1233. 3.13                  Fixed some bugs having to do with long text
  1234.                  messages (observed when testing Spanish language
  1235.                  version).  Improved detection of full target disk.
  1236.                  
  1237. 3.12                  Made the order of driver menu choices dependent
  1238.                  on the order of the associated entries in
  1239.                  INSTALL.HLP.
  1240.                  
  1241.                       Added autodetection for audio (Chris Smith).
  1242.                  
  1243. 3.11                  Added floppy = yes entry to default config file.
  1244.                  
  1245. 3.10                  Moved all text into text file(s).
  1246.                  
  1247. 3.00                  Show menu of default choices.  Read existing
  1248.                  config file.
  1249.                  
  1250.  
  1251.  
  1252.