1) Unpack the tar archive file into a new directory by issuing the
   following commands:

   $ cd /usr/src
   $ tar zfvx vt1500.tgz

2) Compile the source code (you need to have GCC, GNU-make, flex and bison):

   $ make all

3) Make sure you are root

   $ su

4) Call `tv' to create the system-wide configuration file; if you know
   what port your VT1500 is configured for, pass the address on the
   command line and surpress auto-probing (this might otherwise
   confuse interface cards that map port 0x200 or port 0x300;
   e.g. CD-ROM interfaces or network interfaces; if the program keeps
   claiming that there is not VT1500 card, this might be due to missing
   status reporting in some broken cards --- in this case, you *must* use
   `--force' and supply the `--port' address):

   # ./tv --port 0x200
    or
   # ./tv --port 0x300

   If you want to surpress verification of the port address call:

   # ./tv --port 0x200 --force
    or
   # ./tv --port 0x300 --force

   If you want `tv' to automagically figure out how your system is
   configured call it without any command line parameters:

   # ./tv

   You will now probably have to switch to the console, that `tv' was
   started on (press CTRL-ALT-F??). If you do not want to switch virtual
   consoles, start `tv' with the `--novt' option. Warning! This disables
   detection of console changes which can be really annoying if you can
   only see the TV image but do not know if the program is active; this
   is especially dangerous when starting `tv' under X, as your `xterm'
   could accidentally lose focus, while the TV image is active!
   You have been warned...

5) Program all Channels by selecting the appropriate frequency and
   then pressing `E' or <RETURN>. If you do not know what frequency
   you have to select, press `A' to scan through the entire frequency
   range. Whenever you can see a picture or hear a TV station press
   <SPACE>, this will mark the station in the frequency list;
   afterwards you will have to do some fine-tuning.

   Note! It is intended, that you can use the same keys strokes for
   controlling the program as you would do with the DOS version of the
   driver. Furthermore, you can use all the accelerator keys that are
   marked in the menu, plus you can enter station numbers numerically.
   Sometimes, though, the function keys and the cursor keys fail to work
   (you can still use emacs-style cursor movement keys, though). This is
   usually caused by using a poorly configured `terminfo' database. In this
   case, you should try to get hold of a recent copy of `ncurses' (recent
   releases always come with an updated copy of the terminfo database);
   furthermore, make sure that you set up links for
   `/usr/lib/terminfo/c/console' (and possibly for all valid `conWWxHH'
   combinations too; this should at the very least include your standard
   boot resolution, which is usually `con80x25'); these database entries should
   all be linked to `/usr/lib/terminfo/l/linux'!

   `tv' will try to start up even if the `TERM' environment variable is
   not initialized properly (it, then assumes, that you have a `vt100'
   compatible terminal); nonetheless, having a misconfigured system is
   still a bad thing! You'd better try to have both a sensible value for
   `TERM' *and* the appropriate `terminfo' entry (also, even though having an
   entry in `/etc/termcap' is not required by `tv', making sure it is there
   is still a smart move...)

6) Perform all required presettings; such as: volume, bass, treble,
   color adjustment, etc...

   It has been reported that some VT1500 cards show horizontal streaks
   when used with the standard settings. In this case, you should try to
   experiment with lower values for saturation, contrast, brightness, and/or
   red/green/blue. As this phenomenon tends to show up for very saturated
   colors which are not part of every tv scene, it might be a good idea
   to chose settings that are a little below the upper limit.

7) Leave the program and load the file `~/.tvrc' into your editor; check
   that there is an (uncommented) line specifying your card's port
   address. (Note! When `tv' has been launched from `init', its home
   directory will be the root directory, thus the configurations file will
   be in `/.tvrc'! This should not affect you right now, but it might be
   noteworthy, if ever you want to edit this file, while `tv' is already
   running; in that case you will probably have to do `make install-stop'
   first)

   # emacs ~/.tvrc

   ...or, if you are one of these eVIl heritics ;-)

   # vi ~/.tvrc

8) If you do not want your users to have their individual preferences,
   uncomment the line `readonly'. (Actually, uncommenting this line is
   recommended, if you install `tv' in your `/etc/inittab')

9) If your signal input is connected to the antenna line and you have
   a soundcard that is connected to the audio input lines, you might
   want to uncomment the line that reads `externalmute'. Now, whenever
   you mute the TV, you can hear what is send to the audio input
   lines. Beware though, the volume and bass/treble control will now also
   affect the audio signals from your soundcard!

10)You now have to install the system-wide configuration file; this includes
   copying `tv' to `/usr/bin' and updating your `/etc/inittab', so that `tv'
   will automagically be run on your virtual console number 12. The easiest
   way to do that is by invoking `make install'

   (N.B. there has been one report of possible interference between `tv' and
   the scsi-idle kernel patch; this sounds a little bit unlikely, but as I
   do not have the kernel patch myself, I can neither confirm the report nor
   prove it wrong --- if you have this kernel patch *and* you experience
   strange system crashes, you might consider not to install `tv' in
   the `inittab'; caveat emptor ;-)

   If you rather want to do the installtion manually please have a look at the
   `Makefile' (read the source, Luke :-] ) first and then do:

   # make install-no-inittab

   (you can now do `make install' in all subsequent calls, as long as you
   have done no intermediate `make clean')

   On the other hand --- that is, if you trust me :-) --- you can have
   everything done automagically; for most users this will be the prefered
   installation method!

   # make install

   Install might possibly fail if you use a non-standard version of `init'
   which does not know about `telinit q'; if that is the case, you will
   have to edit the `Makefile' and replace all occurences of
   `/sbin/telinit q' with whatever command is neccessary to have your
   `init' process rescan `etc/inittab' (something along the lines of
   `kill -HUP 1' or `kill -1 1' might work, though you will probably have to
   add a `sleep 20' (or the like) after them)

   In order to access the program, switch to virtual console 12 now (this
   assumes, you used `make install'; otherwise, the program might run on the
   first available free console) When you want to switch back to the console
   from where you started the program, you could usually press ALT-PRTSCREEN
   (which should always get you back to the console that was previously active),
   but this may fail with some (all ?) versions of XFree86. In that case,
   you will have to know the console number and then press either ALT-F?? or
   ALT-CTRL-F?? to switch.

11)Remove all temporary files and switch back to user mode:

   # make clean
   # exit
   $

12)Press CTRL-ALT-F12 and enjoy... (If you still have to make
   adjustments to your configuration file; add a comment to the
   `readonly' command and exit the program; it will automagically be
   restarted by your `init' process; do not forget to move your private
   configuration file `~/.tvrc' (or `/.tvrc') to `/usr/local/etc/system.tvrc'
   by calling `make install' after you have done all necessary changes.
   BTW, if you need to temporarly disable `tv' from being re-run by
   `init', you will appreciate the commands `make install-start' and
   `make install-stop')
