
	This is a short file describing the installation of VLT.

Other files you will need and ones you may want
-----------------------------------------------

	VLT uses certain other files that are not distributed with
VLT. Some of these you *must* have, others are just nice.

1. VLT uses arp.library under AmigaDOS 1.3 *and* 2.04, so you must
   have this file in libs: (but just arp.library, not the rest of
   the files that usually come with ARP). Version 39.1 is required
   (commonly known as ARP 1.3). Under 2.04, VLT uses ARP considerably
   less, but can't do without it.

2. Under AmigaDOS 1.3, you must install ConMan if you want to use
   the chat window. The current ConMan version is 1.3e. Under 2.04
   you can use the console handler that comes with the system. If
   you have WShell 2.0, you don't need ConMan, see the WShell docs.
   If you want to use the VLT-ConsoleMenus file in s/, you must have
   WShell 2.0. None of this is absolutely required, but the console
   window might not open, or not open in the right place.

3. If you intend to play with FifoBBS.rexx and similar Fifo: based
   utilities, you must install the Fifo: handler by Matt Dillon.
   Not needed for normal operation.

4. VLT will complain if it cannot find the external file transfer
   protocol library (XPR) that is currently selected. While it seems
   that XMODEM and Kermit are built in, they really are not. Despite
   the complaint, VLT will run fine anyway (but can't transfer files).
   It would be good to acquire the freely distributable XPR libraries
   of your choice. Currently, there exist ones for XMODEM, Kermit,
   ZMODEM, Jmodem, CompuServer Quick-B, and YMODEM. An ASCII XPR
   is included (xprascii.library).

5. There are lots of nice VLT scripts that you may be interested in,
   written by others. Some implement phone books (see however also
   the one included with this distribution), others, automated
   up/download facilities for on-line services.


Installation: First time users (but upgraders, read anyway!)
------------------------------------------------------------

	If this is the first time you have downloaded VLT, then the
installation is very simple.

1. You have already extracted all files from this archive. You should
   have done this using the command:

	lha -x -a x vlt5p517.lha

   If you did not do it that way, please start over. It is important
   to create all subdirectories, and also the -a part is necessary.

2. Now that you have extracted all files, you should see, from the
   Workbench, a drawer called VLT. Drag this drawer to the place where
   you want VLT to live.

   If you want to install VLT on a floppy, consult the manual (see
   vlt/docs/VLT.manual). You will have to delete a lot of files on a
   Workbench floppy to make room for VLT.

3. If you are running AmigaDOS 2.04, you are now essentially done. (See
   however the section on other files VLT needs). If you want to make VLT
   resident, see also point 4.

   When you open the VLT drawer, you will see the VLT icon, and also a VLT
   script icon. Double click on VLT to start it, or double click on the
   VLT script icon to see how that goes.

   Note, that most files that come with this archive do not have icons.
   If you select "show all files" you can browse around and see what else
   there is. Of special interest is the docs drawer, which has a largish
   doc file in it detailing the changes from the last version. This file
   assumes that you have the manual for the previous version of VLT,
   which can be obtained free of charge from SLAC. See the file VLT.Manual
   in the same directory. Each subdirectory has a brief readme file
   explaining what all the files in that subdirectory are for.

4. If you are still running AmigaDOS 1.3, or if you intend to make VLT
   resident, then you must assign vlt: to the directory that contains VLT.
   I.e., if you copied the VLT drawer to your work: partition, then you
   must assign VLT: to work:VLT. Add the line:

	assign VLT: work:VLT

   to your startup sequence.

5. If you run from a shell a lot, you probably want to add a path to the
   directory that VLT lives in. This goes for 1.3 as well as 2.04. Add
   the line:

	path add work:VLT

   to your startup sequence, if that's where VLT's executable is.

6. To tide you over the time you are waiting for the manual, there is an
   ARexx program called MenuHelp.vlt. Execute it using the ARexx Macro...
   menu item in the "Scripts" menu. Follow the instructions to get brief
   help on all menu items of the main screen.


Upgrades to older versions of VLT
---------------------------------

	If you're upgrading from an older version of VLT you have
to make a decision first. You can either install VLT in a directory
somewhere, with all the files it needs, or you can install VLT like
you installed the previous versions. If you want to take the easy way
out, just install it the way you installed it previously (i.e., devs
files go to devs:, libs files to libs:, s files to s: etc.). Note that
in that case you want to combine the scp files and rexx files all into
rexx:.
	Alternatively, you can take the opportunity to clean up your
system some. In principle the installation then is similar to the way
described above for new users, but you probably have lots of files
of your own that you want to copy to subdirectories in the new VLT
directory. But you have to be careful to not overwrite the new files
that came with VLT with the old ones you already had, and also you
want to be careful to not overwrite your own configuration files with
the new ones that come with VLT.
	Here's a possible installation sequence:

1. Unpack the VLT archive as described above.

2. Make a directory called, say, work:vltnew . Also make directories
   work:vltnew/rexx and work:vltnew/scp .

3. copy rexx:*.vlt work:vltnew/rexx
   copy rexx:*.scp work:vltnew/scp
   Also copy all other VLT-related rexx files to work:vltnew/rexx .

4. From the Workbench, drag the VLT drawer that was created when you
   unpacked the archive, to work:. You should now have a VLT and a
   VLTNew drawer on work:.

5. From the CLI, do:
	copy work:VLT work:VLTnew all

6. Now delete work:VLT as follows:
        delete work:VLT all

7. Now rename VLTnew to VLT:
	rename work:VLTnew work:VLT

8. Now copy the configuration files:
	copy s:VTPrefs.dat work:VLT/s
	copy s:TekPrefs.dat work:VLT/s
   If you made changes to s:TekProlog.ps, make the same changes again to
   work:VLT/s/TekProlog.ps.
   Delete these files from s:.

9. Copy all the XPR libraries you have, if you wish, to work:VLT/libs .
   Then delete these files from libs:.

10. If you wish, you can now delete all VLT specific fonts from fonts: .
	delete fonts:vlt* all

11. If you are running under 1.3, or intend to make VLT resident, also
    under 2.04, make a VLT: assignment, as in the "new user" case. Under
    1.3 and 2.04, if you run from a shell a lot, add the directory VLT
    lives in to your path (see new user installation points 4 and 5).

12. If you find that VLT in certain cases can't find certain files, read
    the section about "path searches" in the doc file carefully. You
    can almost always make VLT: find files by making some more
    assignments, or by consolidating files in certain directories, or
    by eliminating directories you're not actually using that VLT finds
    anyway.

	This completes the VLT installation.

	Willy Langeveld, March 1992.

