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