Installation
************

  To compile and install Dvipsk:

   * Edit the top-level `Makefile.in' if you want to make changes that
     will have effect across different runs of `configure'; for example,
     changing the installation directories. (Alternatively, override
     the make variables on the command line when you run make.)

   * Edit `kpathsea/paths.h.in' to define your local default paths.

   * Run `sh configure' in the top-level directory.  This tries to
     figure out system dependencies and the installation prefix.  *Note
     The `configure' script: (kpathsea)configure, for options and other
     information about `configure'.

   * If necessary, edit the paths or other definitions in the files
     `Makefile' and in `dvipsk/c-auto.h' (which `configure' created.)

   * Run `make'; e.g., just type `make' in the top-level directory.
     Barring configuration and compiler bugs, this will compile all the
     programs.  See the `./MACHINES' for possibly helpful
     system-dependent information.

   * Check the paths in `MakeTeXPK', unless you do not want automatic
     font generation (in which case you need not install `MakeTeXPK' at
     all).  *Note Font Generation::.  The `MakeTeXPK' in the
     distribution will overwrite the installed file only if the latter
     contains the string `original MakeTeXPK --'. Dvipsk, unlike the
     original dvips, requires `MakeTeXPK' to echo the generated filename
     (and nothing else) to standard output (standard error can be used
     for commentary). For more details, or in general if your
     `MakeTeXPK' fails, *note Unable to Generate Fonts::..

   * Update the device parameters (available memory, resolution, etc.)
     in `config.ps'.  This file is installed as the system-wide
     configuration file.  *Note Config File Options::.  The `config.ps'
     in the distribution will overwrite the installed file only if the
     latter contains the string `original config.ps --'.

   * Install the programs and supporting macros, fonts, and data files
     with `make install'. If you want to install only the executables,
     do `make install-exec'; for only the data files, `make
     install-data'. And if you don't want to install the fonts (perhaps
     because your directory structure is different from the default),
     set the Make variable `install_fonts=false'.

   * If you want to use more than one device, create configuration
     files for each and install them in the directory named by the Make
     variable `configdir'.

  If you encounter problems, report them to `tex-k@cs.umb.edu'.  To get
on this mailing list, email `tex-k-request@cs.umb.edu' with a message
whose body contains a line
     subscribe YOUR-PREFERRED-EMAIL-ADDRESS

Include the version number of Dvipsk, the system you are using, and
enough information to reproduce the bug in your report.

  To avoid wasted effort and time (both mine and yours), I strongly
advise applying the principles given in the GNU C manual (*note
Reporting Bugs: (gcc)Bugs.) to your bug reports for this (and any)
software.

  Please also report bugs in this documentation--not only factual
errors, but unclear explanations, typos, wrong fonts, ....

