home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / comm / ts3m.zip / INSTALL.TXT < prev    next >
Text File  |  1994-12-23  |  15KB  |  401 lines
  1.  
  2.  
  3.                The Quick & Easy Install manual                 Page 1
  4.  
  5.  
  6.  
  7.  
  8.                         _______
  9.                    ____|__     |               (R)
  10.                 --|       |    |-------------------
  11.                   |   ____|__  |  Association of
  12.                   |  |       |_|  Shareware
  13.                   |__|   o   |    Professionals
  14.                 -----|   |   |---------------------
  15.                      |___|___|    Member
  16.  
  17.  
  18.  
  19.           December, 1994
  20.  
  21.  
  22.           Install is designed to allow you to install and run your
  23.           software including demonstration programs, and maintenance
  24.           software.  You may also use it as a general install program,
  25.           to setup software that you only use occasionally and the
  26.           like.  Install stores its help information and script
  27.           instructions in the INSTALL.DBF and INSTALL.DBT Xbase database
  28.           files.  You can edit the help by tapping F7 instead of F1
  29.           -Help while running install or you can start install with the
  30.           "EDIT" command line parameter.  Install always looks in the
  31.           last active, or undeleted, entry for its script instructions.
  32.           You can take advantage of this by putting alternate
  33.           installation sets in other dbase deleted entries and
  34.           undeleting them for particular disk distributions.  Don't
  35.           leave the last entry blank, or install will yell at you.
  36.  
  37.  
  38.           Command line parameters
  39.  
  40.           INSTALL [EDIT ADD MONO RECNO#]
  41.  
  42.           EDIT   - to edit the script database
  43.           ADD    - to add a new entry and edit the script database.
  44.           MONO   - to force monochrome screen output.
  45.  
  46.  
  47.           The install script language follows:
  48.  
  49.  
  50.           # is used for comments.  Anything to the right of a # is
  51.           considered a comment.
  52.  
  53.           Every install script must start with the line.
  54.           "TELESHARE INSTALL SCRIPT"
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                The Quick & Easy Install manual                 Page 2
  61.  
  62.  
  63.           Otherwise the installer might try to work over one of its own
  64.           help files, and snivel at you.
  65.  
  66.  
  67.           BROWSE somefile to browse or review some text file for
  68.           information.  It has a built-in search capability.
  69.  
  70.           CHANGEDISK key_file To prompt to change to the next diskette,
  71.           and to check for the specified key file on the next disk.  You
  72.           can leave a space and add a message that will be displayed in
  73.           place of "Please change disks" after the key_file name.  Do
  74.           not use a zero length key_file name.
  75.  
  76.           CHANGEDISK peaches.exe Please change to the red disk.
  77.  
  78.           CLEAR to clear the screen.  This version actually calls the
  79.           DOS CLS to ensure that the screen color/colour matches similar
  80.           DOS related commands that you may be using in association with
  81.           it.
  82.  
  83.           COMMAND to directly run programs and to pass commands to
  84.           command.com.  See the RUN and SWAP commands below.
  85.  
  86.           COPY - to allow copying of materials from the source to target
  87.           disk as in:
  88.           COPY file_1 file_2 file_3 etc
  89.  
  90.           The destination is the DIRECTORY provided earlier.  If you are
  91.           installing from a hard drive it assumes that you want to
  92.           install in the same directory, and yells at you if you decide
  93.           otherwise.
  94.  
  95.  
  96.           DIRECTORY - to supply a directory name for editing.
  97.  
  98.           ECHO like the DOS echo.  Anything that is not recognised by
  99.           the script parser is simply echoed to the screen, but any
  100.           spaces on the left side will be trimmed off.
  101.  
  102.           IF and END or ENDIF If is used with ADD-IN or BASIC, as in
  103.           IF  BASIC
  104.              # installation commands for the BASIC option
  105.              ...
  106.           ENDIF
  107.           IF ADD-IN
  108.              # installation commands for the ADD-IN option
  109.              ...
  110.           END
  111.           if add-in basic
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                The Quick & Easy Install manual                 Page 3
  118.  
  119.  
  120.              # to combine the partial installation options
  121.              ...
  122.           endif
  123.  
  124.           IF direct_install
  125.              # direct_install is a logical switch
  126.              # that becomes TRUE if the 'last file'
  127.              # is found at the start of the install
  128.              run save HOMENU.BAT
  129.              QUIT
  130.           ENDIF
  131.  
  132.           The final "END" or "ENDIF" is an implied "QUIT", so if you use
  133.           one of the two optional partial installation options, ensure
  134.           that the 'right stuff' is done before the "END".
  135.  
  136.           There is no "IF ALL" to install everything.  If the option to
  137.           install everything is chosen, any "IF BASIC" or "IF ADD-IN"
  138.           instruction sets are ignored.
  139.  
  140.           INSTALL DIRECTORY \HANDS_ON\ # to specify the \HANDS_ON\
  141.           directory.
  142.  
  143.           INSTALL HEADER - This allows you to provide an alternate
  144.           header to replace the default message at the upper part of the
  145.           screen.  You may use up to 3 message or header lines.
  146.  
  147.           INSTALL README some_file to allow you to use any file name
  148.           instead of the default README.DOC name.  README.DOC is used in
  149.           place of README.1ST to make it easier to look up a group of
  150.           manuals, ending in ".DOC", with various browsers.
  151.  
  152.           INSTALL ADD-IN or BASIC - to specify that the distribution is
  153.           only a partial distribution.  The installer defaults to asking
  154.           if you want 1) A FULL distribution or 2) Only the REMOTE or
  155.           the HOST (BASIC) or 3) As an ADD-IN to another product like
  156.           bitcom.  Use one of these command options to bypass the
  157.           prompting.
  158.  
  159.           QUIT - to instruct INSTALL to quit to DOS.
  160.  
  161.           QUIT_TO to quit and run another program.  This version of
  162.           Install does NOT use keyboard stuffing to run the next
  163.           program, unlike previous releases.  When you use "QUIT_TO
  164.           some_prog" the program swaps all but 2k of itself to disk and
  165.           runs the "some_prog".  It then swaps itself back in after
  166.           running and immediately quits.
  167.  
  168.           LASTFILE to specify the last file in a disk set.  This allows
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                The Quick & Easy Install manual                 Page 4
  175.  
  176.  
  177.           the installer to look for the last file and automatically
  178.           decide that the installation is a 'one disk' set.  This allows
  179.           you to use the same installation instruction script for 360K
  180.           diskettes, 1.44M diskettes, and BBS type installation.  It
  181.           causes CHANGEDISK type instructions to be ignored.  eg.:
  182.           "LASTFILE lastdisk.zip".  The Sept/94 update adds a logical
  183.           switch DIRECT_INSTALL that becomes True if the LASTFILE is
  184.           present when the installer reads in the install script in
  185.           install.dbf.  You can use it with IF ... ENDIF as shown above,
  186.           most likely for installations from files downloaded from a
  187.           BBS.  If you are installing an update and the lastfile already
  188.           exists in the target directory, the installer will assume a
  189.           BBS type of installation and bypass most of the update.  So
  190.           erase the lastfile before doing the update.
  191.  
  192.           # if the 'lastfile' has been found this IF will be entered
  193.           IF direct_install
  194.             some stuff
  195.             ...
  196.             quit
  197.           ENDIF
  198.  
  199.           Please note that a side effect of the LASTFILE command is that
  200.           the installer logical rule base goes bonkers if you use
  201.           LASTFILE and install a second time over the first set of
  202.           files, from 5 1/4" diskettes.  It then decides that you are
  203.           actually installing from a 3 1/2" diskette, and mistakenly
  204.           avoids asking you to change disks.
  205.  
  206.           RUN - to tell INSTALL to run the program on the same line.
  207.           For both RUN and SWAP, install looks for the file to be run in
  208.           both the source and the des