-*- text -*-
Installation notes for dpg-view
$Id: INSTALL,v 0.3.2.0 1992/06/11 22:47:35 dpg Alpha dpg $

First, you need to install the vgalib and header file in some standard
place (normally /usr/lib/statis and /usr/include).

Then adjust the Makefile (you'll probably be able to leave it as it
is), and just hit make (with or without the target name of `all').

Other Makefile targets are `proto', which uses Eric Smith's mkptypes
program to generate the function prototype header, `pretty', which
indents any source files which have changed since `pretty' was last
made (assumes GNU indent), `tar', which creates a distribution tar
file, and `doc', whcih formats and installs documentation.

Notes on system requirements

Versions up to 0.2.5 required the pbmplus libraries to compile.
Subsequent versions do not.  In future, no code will require special
libraries other than the display driver.

Versions from 0.3.0 onwards require the GNU getopt (for long option
anme parsing).  This is part of the GNU C libray; if you don`t have
this library (eg. Linux with an old GCC), you'll have to add the
getopt.h, getopt.c, and getopt1.c files (these can be found in almost
any GNU source distribution).

I hacked the VGA library to use it's own console file descriptor
instead of fd 0, so that reading from standard input would work. I
sent the patches to Tommy, but so far he hasn't replied (hopefully
they _will_ be in the next vgalib), but until then you may experience
trouble reading from stdin.

As has been pointed out by a couple of people, older versions of the
vgalib don't restore the color registers after use, so you may have
difficulty seeing your text after a run.  You can either get the
latest library release (naturally the best solution), or write a short
program to set register 0 to black and register 7 to white (I think
that's right) and use it to restore the most important two colors
after each run.
