home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / comprgs / vltj5576.lha / Installation next >
Encoding:
Text File  |  1992-08-11  |  8.4 KB  |  198 lines
  1.  
  2.     This is a short file describing the installation of VLT.
  3. There are some changes from version 5.517. They are indicated by
  4. "change bars".
  5.  
  6. Other files you will need and ones you may want
  7. -----------------------------------------------
  8.  
  9.     VLT uses certain other files that are not distributed with
  10. VLT. Some of these you *must* have, others are just nice.
  11.  
  12. 1. VLT uses arp.library under AmigaDOS 1.3 *and* 2.04, so you must
  13.    have this file in libs: (but just arp.library, not the rest of
  14.    the files that usually come with ARP). Version 39.1 is required
  15.    (commonly known as ARP 1.3). Under 2.04, VLT uses ARP considerably
  16.    less, but can't do without it.
  17.  
  18. 2. Under AmigaDOS 1.3, you must install ConMan if you want to use
  19.    the chat window (console). The current ConMan version is 1.3e.
  20.    Under 2.04 you can use the console handler that comes with the
  21.    system. If you have WShell 2.0, you don't need ConMan, see the
  22.    WShell docs. If you want to use the VLT-ConsoleMenus file in s/,
  23. |   you must have WShell 2.0. Note also, that the console menus only
  24. |   work under AmigaDOS 2.04. None of this is absolutely required, but
  25.    the console window might not open, or not open in the right place.
  26.  
  27. 3. If you intend to play with FifoBBS.rexx and similar Fifo: based
  28.    utilities, you must install the Fifo: handler by Matt Dillon.
  29.    Not needed for normal operation.
  30.  
  31. 4. VLT will complain if it cannot find the external file transfer
  32.    protocol library (XPR) that is currently selected. While it seems
  33.    that XMODEM and Kermit are built in, they really are not. Despite
  34.    the complaint, VLT will run fine anyway (but can't transfer files).
  35.    It would be good to acquire the freely distributable XPR libraries
  36.    of your choice. Currently, there exist ones for XMODEM, Kermit,
  37.    ZMODEM, Jmodem, CompuServer Quick-B, and YMODEM. An ASCII XPR
  38.    is included (xprascii.library).
  39.  
  40. | 5. Some of the ARexx programs that come with VLT *require* that you
  41. |    have rexxarplib.library version *3.0*. Earlier versions of
  42. |    rexxarplib.library will not work correctly. Rexxarplib.library
  43. |    is available on BIX and on the anonymous FTP site
  44. |    unixhub.slac.stanford.edu, as well as various online services
  45. |    and BBS's.
  46.  
  47. 6. There are lots of nice VLT scripts that you may be interested in,
  48.    written by others. Some implement phone books (see however also
  49.    the one included with this distribution), others, automated
  50.    up/download facilities for on-line services.
  51.  
  52.  
  53. Installation: First time users (but upgraders, read anyway!)
  54. ------------------------------------------------------------
  55.  
  56.     If this is the first time you have downloaded VLT, then the
  57. installation is very simple.
  58.  
  59. 1. You have already extracted all files from this archive. You should
  60.    have done this using the command:
  61.  
  62.     lha -x -a x vlt5p517.lha
  63.  
  64.    If you did not do it that way, please start over. It is important
  65.    to create all subdirectories, and also the -a part is necessary.
  66.  
  67. 2. Now that you have extracted all files, you should see, from the
  68.    Workbench, a drawer called VLT. Drag this drawer to the place where
  69.    you want VLT to live.
  70.  
  71.    If you want to install VLT on a floppy, consult the manual (see
  72.    vlt/docs/VLT.manual). You will have to delete a lot of files on a
  73.    Workbench floppy to make room for VLT.
  74.  
  75. 3. If you are running AmigaDOS 2.04, you are now essentially done. (See
  76.    however the section on other files VLT needs). If you want to make VLT
  77.    resident, see also point 4.
  78.  
  79.    When you open the VLT drawer, you will see the VLT icon, and also a VLT
  80.    script icon. Double click on VLT to start it, or double click on the
  81.    VLT script icon to see how that goes.
  82.  
  83.    Note, that most files that come with this archive do not have icons.
  84.    If you select "show all files" you can browse around and see what else
  85.    there is. Of special interest is the docs drawer, which has a largish
  86.    doc file in it detailing the changes from the last version. This file
  87.    assumes that you have the manual for the previous version of VLT,
  88.    which can be obtained free of charge from SLAC. See the file VLT.Manual
  89.    in the same directory. Each subdirectory has a brief readme file
  90.    explaining what all the files in that subdirectory are for.
  91.  
  92. 4. If you are still running AmigaDOS 1.3, or if you intend to make VLT
  93.    resident, then you must assign vlt: to the directory that contains VLT.
  94.    I.e., if you copied the VLT drawer to your work: partition, then you
  95.    must assign VLT: to work:VLT. Add the line:
  96.  
  97.     assign VLT: work:VLT
  98.  
  99.    to your startup sequence.
  100.  
  101. 5. If you run from a shell a lot, you probably want to add a path to the
  102.    directory that VLT lives in. This goes for 1.3 as well as 2.04. Add
  103.    the line:
  104.  
  105.     path add work:VLT
  106.  
  107.    to your startup sequence, if that's where VLT's executable is.
  108.  
  109. 6. To tide you over the time you are waiting for the manual, there is an
  110.    ARexx program called MenuHelp.vlt. Execute it using the ARexx Macro...
  111.    menu item in the "Scripts" menu. Follow the instructions to get brief
  112.    help on all menu items of the main screen.
  113.  
  114.  
  115. Upgrades to older versions of VLT
  116. ---------------------------------
  117.  
  118.     If you're upgrading from an older version of VLT you have
  119. to make a decision first. You can either install VLT in a directory
  120. somewhere, with all the files it needs, or you can install VLT like
  121. you installed the previous versions. If you want to take the easy way
  122. out, just install it the way you installed it previously (i.e., devs
  123. files go to devs:, libs files to libs:, s files to s: etc.). Note that
  124. in that case you want to combine the scp files and rexx files all into
  125. rexx:.
  126.     Alternatively, you can take the opportunity to clean up your
  127. system some. In principle the installation then is similar to the way
  128. described above for new users, but you probably have lots of files
  129. of your own that you want to copy to subdirectories in the new VLT
  130. directory. But you have to be careful to not overwrite the new files
  131. that came with VLT with the old ones you already had, and also you
  132. want to be careful to not overwrite your own configuration files with
  133. the new ones that come with VLT.
  134.     Here's a possible installation sequence:
  135.  
  136. 1. Unpack the VLT archive as described above.
  137.  
  138. 2. Make a directory called, say, work:vltnew . Also make directories
  139.    work:vltnew/rexx and work:vltnew/scp .
  140.  
  141. 3. copy rexx:*.vlt work:vltnew/rexx
  142.    copy rexx:*.scp work:vltnew/scp
  143.    Also copy all other VLT-related rexx files to work:vltnew/rexx .
  144.  
  145. 4. From the Workbench, drag the VLT drawer that was created when you
  146.    unpacked the archive, to work:. You should now have a VLT and a
  147.    VLTNew drawer on work:.
  148.  
  149. 5. From the CLI, do:
  150.     copy work:VLT work:VLTnew all
  151.  
  152. 6. Now delete work:VLT as follows:
  153.         delete work:VLT all
  154.  
  155. 7. Now rename VLTnew to VLT:
  156.     rename work:VLTnew work:VLT
  157.  
  158. 8. Now copy the configuration files:
  159.     copy s:VTPrefs.dat work:VLT/s
  160.     copy s:TekPrefs.dat work:VLT/s
  161.    If you made changes to s:TekProlog.ps, make the same changes again to
  162.    work:VLT/s/TekProlog.ps.
  163.    Delete these files from s:.
  164.  
  165. 9. Copy all the XPR libraries you have, if you wish, to work:VLT/libs .
  166.    Then delete these files from libs:.
  167. |    If you have other programs that need access to the XPR libraries,
  168. |    it is probably better to leave them in libs:
  169. |    However, you can now delete from libs: the following libraries:
  170. |    review.library, strokefont.library, duplexfont.library and
  171. |    simplexfont.library.
  172.  
  173. 10. If you wish, you can now delete all VLT specific fonts from fonts: .
  174.     delete fonts:vlt* all
  175.  
  176. 11. If you are running under 1.3, or intend to make VLT resident, also
  177.     under 2.04, make a VLT: assignment, as in the "new user" case. Under
  178.     1.3 and 2.04, if you run from a shell a lot, add the directory VLT
  179.     lives in to your path (see new user installation points 4 and 5).
  180.  
  181. 12. If you find that VLT in certain cases can't find certain files, read
  182.     the section about "path searches" in the doc file carefully. You
  183.     can almost always make VLT: find files by making some more
  184.     assignments, or by consolidating files in certain directories, or
  185.     by eliminating directories you're not actually using that VLT finds
  186.     anyway.
  187.  
  188. | 13. In order to use, in particular, the new review.library, you must
  189. |     flush the old version from memory. The only sure way of doing this
  190. |     is to make sure the old version is not in libs:, and then reboot.
  191. |     The command "version review.library" should return:
  192. |         review.library 1.31
  193.  
  194.     This completes the VLT installation.
  195.  
  196. |    Willy Langeveld, July 1992.
  197.  
  198.