
Compiling and Installing Xdvik
==============================

Xdvik is the kpathsea-enhanced version of xdvi. The program
invocation name is still `xdvi' for compatibility reasons.

Please submit bug reports, suggestions etc. to the sourceforge
xdvik project page:

	http://sourceforge.net/projects/xdvi/


Note for users of older versions of teTeX (<= teTeX-1.0):
=========================================================

   Please consult  the README file in the texk/xdvik/texmf-alt/
   directory of the source distribution.


Note for users of non-teTeX installations:
==========================================

   Please consult the files texk/xdvik/texmf-alt/README and
   texk/xdvik/README.t1fonts for information on how to configure
   xdvik for direct Type1 font rendering.


1. Required Software

   - X11R5 or newer and the Xt libraries

   and one of:

   - Xaw (Athena widgets)

   - Motif >= 1.2 or newer
     LessTif has a few bugs and restrictions that will result in limited
     functionality (see the file texk/xdvik/LESSTIF-BUGS for details).
     For best results, use OpenMotif 2.x.

   You need both the headers and the runtime libraries to compile and run
   xdvik (Note: Some Linux distributors may put the headers into a separate
   `X development' package).

2. Configuring:

   In the top-level directory (the directory in which this INSTALL
   file is located), invoke:

	./configure

   You can also specify a toolkit via the --with-x-toolkit option
   (the default is to check if Motif is available and use it if it is):

       ./configure --with-x-toolkit=xaw [other-options]

   will compile with Xaw (Athena widgets) instead. You can set
   the search paths for Motif header/library files with the
   --with-motif-include and --with-motif-libdir options.

   If configure gives you errors about the main texmf tree not being
   found, specify its directory via the `--datadir' option.
   On a standard teTeX system, use the output of the command:

	kpsewhich --expand-path='$TEXMFMAIN'

   *without* the `texmf' component as value for `--datadir'
   (/usr/share or /usr/local/teTeX/share are possible values).

   For all configuration options available, see the output of:
       ./configure --help



3. Compiling:

   In the top-level directory, invoke:

        make

   This should compile the executable texk/xdvik/xdvi-TOOLKIT,
   where TOOLKIT is the value of the `--with-x-toolkit' specified
   in the configure step, e.g. `xaw' or `motif' (the default).

   (THIS IS NEW; previously, the executable used to have a ".bin"
   extension; see
   http://sourceforge.net/tracker/index.php?func=detail&aid=1222202&group_id=23164&atid=377580
   for more information on why this was changed.)

   If you set the environment variable XDVIINPUTS to the path
   containing the files xdvi.cfg and ps2pk.map, you should be
   able to test xdvi without actually installing it.



4. Installation:

   Usually, the binary xdvi-TOOLKIT is invoked by a shell wrapper
   `xdvi' which sets XDVIINPUTS and some other variables, like the X
   search path.

   If you only want to upgrade an existing version of xdvik, it should
   be sufficient to copy xdvi-TOOLKIT into a directory in your PATH
   and check that the shell wrapper invokes the correct toolkit version.
   (You may also want to update the man page from xdvi.1). These files
   are located in the texk/xdvik subdirectory.

   To install a new version from scratch, invoke:

	make install

   in the top-level directory to install all executable and data files.
   This will not install the files in the texk/kpathsea subdirectory,
   which is not required if you already have a working TeX installation
   (and actually could overwrite your existing setup). If you don't have
   kpathsea installed yet, you'll need to install it manually; basically
   by doing `cd texk/kpathsea; make install'. Please see the file
   texk/kpathsea/INSTALL for more information.



5. Setup:

   Make sure that the XDVIINPUTS variable (set in the system-wide
   texmf.cnf file or in the environment, e.g. in your .profile)
   contains the path to the directory DATADIR/texmf/xdvi, and
   to the file ps2pk.map (usually in DATADIR/texmf/dvips);
   e.g. by setting:

	export XDVIINPUTS='.:$TEXMF/{xdvi,dvips}//'

   If xdvik is still generating PK versions of fonts that you think
   you have Type1 versions of, please consult texk/xdvik/README.t1fonts
   for more information on how to configure xdvik correctly for Type1
   fonts.

