1                                                  -*- Text -*-
2
3This file describes how to build and install CatDVI version 0.14.
4
5
6REQUIREMENTS:
7
8  * a hosted ISO C (1990) environment
9
10  * the kpathsea library (installed) and accompanying header files
11
12  * only when building from CVS (if you don't know what that means then
13    you aren't): GNU autoconf
14
15Attention:
16  * For GNU/Linux users: with most distributions, it is not enough to have
17    TeX installed; the kpathsea headers are usually contained in an extra
18    package called "libkpathsea-dev" or "tetex-devel" or similar.
19
20  * For teTeX users: there were (are?) some teTeX pre-built binary tarballs
21    with statically linked libkpathsea in existence that did (do?) not include
22    the necessary development files. These will not work.
23
24  * Cross compiling catdvi does not work at the moment.
25
26
27IF YOU HAVE GNU MAKE AND A POSIX SHELL ENVIRONMENT:
28
29This is the easiest way. Note you need _GNU_ make. Really.
30
31  * Only when building from CVS:
32    	autoconf
33
34  * On systems where "make" is GNU make (e.g. Linux):
35	./configure [options]
36	make
37	make install
38
39  * On systems where "make" is not GNU make, but GNU make is available under
40    a different name (e.g. *BSD). The customary name is then "gmake".
41    Assuming this name:
42	MAKE=gmake ./configure [options]
43	gmake
44	gmake install
45
46The options to configure are standard. Type
47    ./configure --help
48for a list.
49
50
51OTHERWISE:
52
53A simple bourne shell script "build.sh" is included in the distribution tarball.
54Edit to your needs and run. Then install the resulting catdvi executable and
55(perhaps) the catdvi.1 man page to appropriate places.
56
57Even if you don't have a bourne shell compatible /bin/sh, it is fairly easy
58to understand what the script does and to adapt it to your environment or
59execute the necessary steps manually.
60