============================================================================= teTeX-0.3.4 installation instructions (compiling the sources) ============================================================================= 1) prerequisites: disk space, gcc, GNU make, flex 2) getting the files 3) install the inputs-tree 4) unpack the sources and apply patches (if there are any): 5) adjust the Makefile 6) run make 7) final configuration steps A) appendix: notes on some platforms ============================================================================ 1) prerequisites: disk space, gcc, GNU make, flex ============================================================================ To compile teTeX, you need gcc, flex and a recent version of GNU make. gcc-2.5.8, flex-2.4.7 and GNU make-3.72.1 or newer should be ok. The gzipped source tree is about 3.8MB, after untarring about 14.8MB, after "make world" completes about 30MB. ============================================================================= 2) getting the files ============================================================================ What you need: sources/teTeX-src-0.3.4.tar.gz # the sources sources/teTeX-src-0.3.4-patch-*.gz # all patches (if available) sources/teTeX-lib-0.3.4.tar.gz # the lib-tree with the fonts, macros, ... Instead of the complete lib-tree, you can get the smaller files with fonts, documentation, ... from the other subdirectories. See INSTALL.bin for notes on installing these files. You do not need to install binaries when installing via INSTALL.bin. ============================================================================ 3) install the inputs-tree ============================================================================ Unpack teTeX-lib-0.3.4.tar.gz at its "final" destination, e.g. cd /usr/local gzip -dc /usr/local/src/teTeX-lib-0.3.4.tar.gz | tar xpvf - You may choose a different directory instead of /usr/local and you may rename the teTeX directory. Just make sure to have the TETEXDIR variable in the top-level Makefile right before starting make. Note: if you omit the "p" option of tar, you may have trouble with permissions later. If you install the smaller packages from the base, fonts, doc and goodies directories, use install.sh (see INSTALL.bin for details). ============================================================================ 4) unpack the sources and apply patches (if there are any): ============================================================================ Unpack the sources, e.g.: cd /usr/local/src gzip -dc teTeX-src-0.3.4.tar.gz | tar xpvf - Apply patches: gzip -dc teTeX-src-0.3.4-patch-* | patch -p0 -s NOTE: if you unpack as root on a SYSV system, you may need to chown -R afterwards, to fix wrong ownerships. ============================================================================ 5) adjust the Makefile ============================================================================ Have a look at the Makefile and adjust what needs to be adjusted. E.g.: cd teTeX-src-0.3.4 vi Makefile ============================================================================ 6) run make ============================================================================ Type "make world" and relax :-) This is equivalent to make config clean texhash all install ini If you need special previleges for 'make install' and 'make ini', you can run two make in two separate runs: make config clean texhash all su make install ini If you install for a second, third, ... platform, you can omit the 'texhash' and 'ini' targets and simply run: make config clean all make install Please note that calling make with an absolute path breaks the configure scripts. The following example _does_not_work_: /usr/local/bin/make world ... checking whether /usr/local/bin/make sets $MAKE... ./configure: ${ac_cv_prog_make_/usr/bin/make_set+set}: bad substitution ... ============================================================================ 7) final configuration steps ============================================================================ Overview: - set up PATH - check environment - configure teTeX using texconfig Set up PATH: =========== Set up your PATH to include the directory containing the just installed binaries (e.g. /usr/local/teTeX/bin/sparc-sunos4.1.3); similarly, MANPATH and INFOPATH to include the relevant newly installed subdirectories. Check environment ================= Note, that the run-time search paths for all programs that use the Kpathsea library can be configured by changing the paths in TETEXDIR/texmf.cnf and changes to these paths does not require to recompile any of the programs. Therefore, you hardly need to set extra environment variables. If you define some environment variables, they overrule the search paths in texmf.cnf unless they have an empty path component (i.e. a colon at the beginning or end or a doubled colon in the middle). The variables to check are: BIBINPUTS BSTINPUTS DVIPSHEADERS GFFONTS GLYPHFONTS MFBASES MFINPUTS MFPOOL PKFONTS TEXCONFIG TEXFONTS TEXFORMATS TEXINPUTS TEXMFCNF TEXPICTS TEXPKS TEXPOOL TFMFONTS VFFONTS DVIPSFONTS XDVIVFS XDVIFONTS DVILJFONTS A simple way to check them is to run texconfig confall once you have set up your PATH. Be careful if some variables are non-empty and have a look at the locations of the binaries. Not all binaries are checked, only some. Configure teTeX using texconfig =============================== Texconfig allows you to set the defaults for hyphenation, paper size, print command, metafont mode, etc. You should run theis command interactively and see what options it offers. ============================================================================= A) appendix: notes on some platforms ============================================================================= SGI-IRIX-6.0.1: (reported by bottoms@radar.nrl.navy.mil (Maitland Bottoms)) successfully compiled using: CC=cc CFLAGS=-O2 -s -32 LDFLAGS=-s -32 ULTRIX: use /bin/sh5 in shell-scripts. AIX 4.X: use /bin/bsh in shell-scripts.