home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / misc / ansip22b / install.doc < prev    next >
Encoding:
Text File  |  1992-02-01  |  8.0 KB  |  188 lines
  1.  
  2.  
  3.                     INSTALLATION of ANSIPLAY vs. 2.2
  4.                     (C) Copyright 1991, J. M. Ibarra
  5.                     --------------------------------
  6.        INSTALL.EXE is used to automate installation procedures
  7.        for ANSIPLAY version 2.2.
  8.  
  9.        THE INSTALLATION PROCESS
  10.        ------------------------
  11.        The installation program is basically broken into 5 procedures:
  12.  
  13.        1.  Installation of your ANSI device driver.
  14.        2.  Setting a PATH in your AUTOEXEC.BAT file.
  15.        3.  Creating/Updating your ANSIPLAY.CLS file.
  16.        4.  Use an environment SETting in your AUTOEXEC.BAT file.
  17.        5.  Option to print manuals and documentation.
  18.  
  19.        DOS command syntax is: INSTALL
  20.  
  21.        1.  Installation of your ANSI device driver.
  22.                The ANSI device driver included with your DOS files is
  23.                names ANSI.SYS.  Before this driver can work, it must be
  24.                installed into your CONFIG.SYS file in the root directory
  25.                of your boot drive.
  26.  
  27.                INSTALL.EXE will ask you which drive\directory this file
  28.                is located upon booting up.  Then it will check to see if
  29.                the device driver is already installed.  If not, it will
  30.                alter (or create) your CONFIG.SYS file.
  31.  
  32.                For more information on ANSI.SYS, consult your DOS user's
  33.                manual.
  34.  
  35.        2.  Setting a PATH in your AUTOEXEC.BAT file.
  36.            (This path is used for searching executable files)
  37.                INSTALL.EXE will ask you on which drive\directory the
  38.                ANSIPLAY program files will be found.
  39.  
  40.                INSTALL.EXE will then search for your AUTOEXEC.BAT file
  41.                on your boot drive.
  42.  
  43.                It will then search for the first occurance of the text
  44.                "PATH " or "PATH=" in the file.  If the text is found,
  45.                the ANSIPLAY files drive\directory will be appended to
  46.                the textline.  If the text is not found, it will be
  47.                appended to the last line of the AUTOEXEC.BAT file.
  48.  
  49.                Consult your DOS user's manual for information on how the
  50.                PATH statement works.
  51.  
  52.        3.  Creating/Updating your ANSIPLAY.CLS file.
  53.                INSTALL.EXE will allow you to select the default colors
  54.                for and whether or not you wish the screen to be cleared
  55.                after each ANSI file display.
  56.  
  57.                See the section on "Reinitializing your screen display"
  58.                for information on the file ANSIPLAY.CLS.
  59.  
  60.        4.  Use an environment SETting in your AUTOEXEC.BAT file.
  61.            (This path is used for searching for ANSIPLAY.CLS DATA file)
  62.  
  63.                               * Page 1 *
  64.  
  65.                INSTALL.EXE will ask you on which drive\directory the
  66.                ANSIPLAY.CLS is to be written to.
  67.                INSTALL.EXE will then search for your AUTOEXEC.BAT file
  68.                on your boot drive.
  69.  
  70.                It will then search for the first occurance of the text
  71.                "SET ANSIPLAY=" or "SET ANSIPLAY " in the file.  If the
  72.                text is found, the ANSIPLAY files drive\directory will
  73.                be appended to the textline.  If the text is not found,
  74.                it will be appended to the last line of the AUTOEXEC.BAT
  75.                file.
  76.  
  77.                Consult your DOS user's manual for information on how the
  78.                SET statement works.
  79.  
  80.        5.  Option to print documentation.
  81.                You will be given an option to select which text files,
  82.                if any, you want to print.  Each selection will be
  83.                preceded with a brief description of the file contents.
  84.  
  85.                Printer output will be sent to default printer (LPT1:).
  86.                During printing you may pause/stop/abort the print job(s)
  87.                by hitting the [ESC] key, at which time you will be given
  88.                3 options...
  89.  
  90.                     C)ontinue...resume printing
  91.                     S)top.......stop printing the file which is currently
  92.                                 being printed, and continue with next file.
  93.                     A)bort......abort all print jobs.
  94.  
  95.       If your CONFIG.SYS and/or AUTOEXEC.BAT files have been updated
  96.       you will be reminded to reboot your system so the the changes
  97.       will automatically be invoked.
  98.  
  99.       To reboot, Hold down the keys...[CTRL], then [ALT], then [DEL].
  100.  
  101.  
  102.   ========== APPENDIX I - TROUBLE SHOOTING (INSTALLATION) ===========
  103.  
  104.        Problem:
  105.            When I entered the letter of the boot drive, the program
  106.            said "Logging onto boot drive..." and never returned.
  107.  
  108.        Reason:
  109.            INSTALL will try to access the drive you specified.  If
  110.            the drive is invalid or unaccessible, the program will be
  111.            sent into infinity.
  112.  
  113.        Solution:
  114.            Reboot, and try again...this time being sure the drive is
  115.            valid and accessible.
  116.  
  117.  
  118.        Problem:
  119.            When INSTALL went to access my CONFIG.SYS, AUTOEXEC.BAT or
  120.            ANSIPLAY.CLS files, it returned an error message.
  121.  
  122.        Solution(s):
  123.            - Be sure that the CONFIG.SYS and AUTOEXEC.BAT files are on
  124.              the drive\directory you specified.
  125.                               * Page 2 *
  126.  
  127.            - Be sure the drive\directory you specified is valid and
  128.              accessible.  Files that are read-only are not accessible
  129.              and will return an error message.
  130.  
  131.            - Be sure the specified drive has enough disk space to write
  132.              the updated data onto.
  133.  
  134.        Problem:
  135.            When I reboot, there was an error in CONFIG.SYS file.
  136.  
  137.        Reason:
  138.            INSTALL.EXE seaches the CONFIG.SYS file for an exact match
  139.            of drive\directory\filename in which the ANSI device driver
  140.            exists.  The device driver may have already been installed
  141.            under a different drive\directory than the one you specified.
  142.  
  143.            Since the path's do not match, INSTALL.EXE assumes that the
  144.            driver is NOT installed therefore installing it twice.  When
  145.            the system is re-boot, the driver is installed twice thus
  146.            causing the error.
  147.  
  148.        Solution:
  149.            Use your text editor to remove the incorrect text line.
  150.  
  151.  
  152.        Problem:
  153.            When entering the drive\directory to locate a file, the
  154.            program sometimes will not accept my keyboard input.
  155.  
  156.        Reason:
  157.            The program has a built-in feature which checks for proper
  158.            pathname syntax during user-interaction.  For example, if
  159.            during a "\" character creates a situation where two "\\"
  160.            characters are found, the program will not accept the
  161.            improper format.
  162.  
  163.        Solution:
  164.            Turn off INSert mode if necessary (by hitting the INS key),
  165.            and type it in properly.  The automatic syntax checking will
  166.            be removed in the next updated version to help simplify user
  167.            input.
  168.  
  169.  
  170.        Problem:
  171.            When the PATH setting is changed, the new PATH is displayed
  172.            on screen.  Before INSTALL.EXE changes the PATH setting, it
  173.            tries to find an existing PATH in the AUTOEXEC.BAT file.
  174.            This is done by searching for the FIRST occurence of the
  175.            text "PATH " (PATH followed by a space), or "PATH=" (PATH
  176.            followed by an equal sign.
  177.  
  178.            If by fluke chance there is another line of text in the
  179.            AUTOEXEC.BAT file, INSTALL.EXE will think this was the line
  180.            to be changed and alter it.
  181.  
  182.        Solution:
  183.            Use your own text editor to fix the line of text which should
  184.            not have been altered.  Then, if you're unsure how to change
  185.            the actual PATH setting, just move the line of text which
  186.            contains the PATH setting to the beginning of the file, and
  187.            re-run install.
  188.                               * Page 3 *