home *** CD-ROM | disk | FTP | other *** search
/ ftp.muug.mb.ca / 2014.06.ftp.muug.mb.ca.tar / ftp.muug.mb.ca / pub / tex / tetex / INSTALL.src < prev    next >
Text File  |  1996-11-17  |  7KB  |  199 lines
  1. =============================================================================
  2.  
  3.     teTeX-0.4 installation instructions (compiling the sources)
  4.  
  5. =============================================================================
  6.  
  7.   1) prerequisites: disk space, gcc, GNU make, flex
  8.   2) getting the files
  9.   3) install the inputs-tree
  10.   4) unpack the sources
  11.   5) adjust the Makefile
  12.   6) run make
  13.   7) final configuration steps
  14.   A) appendix: notes on some platforms
  15.  
  16. ============================================================================
  17.   1) prerequisites: disk space, gcc, GNU make, flex
  18. ============================================================================
  19.  
  20. To compile teTeX, you need gcc, flex and a recent version of GNU make.
  21. gcc-2.5.8, flex-2.4.7 and GNU make-3.72.1 or newer should be ok.
  22.  
  23. The gzipped source tree is about 3.8MB, after untarring about 14.8MB,
  24. after "make world" completes about 30MB.
  25.  
  26. =============================================================================
  27.   2) getting the files
  28. ============================================================================
  29.  
  30. What you need:
  31.     sources/teTeX-src-0.4pl1.tar.gz  # the sources
  32.     sources/teTeX-lib-0.4pl1.tar.gz  # the lib-tree with the fonts, macros, ...
  33.  
  34. Instead of the complete lib-tree, you can get the smaller files with
  35. fonts, documentation, ... from the other subdirectories. See INSTALL.bin
  36. for notes on installing these files. You do not need to install binaries
  37. when installing via INSTALL.bin.
  38.  
  39. ============================================================================
  40.   3) install the inputs-tree
  41. ============================================================================
  42.  
  43. Unpack teTeX-lib-0.4.tar.gz at its "final" destination, e.g.
  44.  
  45.     cd /usr/local
  46.     gzip -dc /usr/local/src/teTeX-lib-0.4pl1.tar.gz | tar xpvf -
  47.  
  48. You may choose a different directory instead of /usr/local and you may
  49. rename the teTeX directory. Just make sure to have the TETEXDIR
  50. variable in the top-level Makefile right before starting make.
  51.  
  52. Note: if you omit the "p" option of tar, you may have trouble with
  53.       permissions later.
  54.  
  55. If you install the smaller packages from the base, fonts, doc and goodies
  56. directories, use install.sh (see INSTALL.bin for details).
  57.  
  58. ============================================================================
  59.   4) unpack the sources
  60. ============================================================================
  61.  
  62. Unpack the sources, e.g.:
  63.     cd /usr/local/src
  64.     gzip -dc teTeX-src-0.4pl1.tar.gz | tar xpvf -
  65.  
  66. ============================================================================
  67.   5) adjust the Makefile
  68. ============================================================================
  69.  
  70. Have a look at the Makefile and adjust what needs to be adjusted. E.g.:
  71.  
  72.     cd teTeX-src-0.4
  73.     vi Makefile
  74.  
  75. ============================================================================
  76.   6) run make
  77. ============================================================================
  78.  
  79. Type "make world" and relax :-)
  80.  
  81. This is equivalent to
  82.   make config clean texhash all install ini
  83.  
  84. If you need special previleges for 'make install' and 'make ini', you can
  85. run two make in two separate runs:
  86.   make config clean texhash all
  87.   su
  88.   make install ini
  89.  
  90. If you install for a second, third, ... platform, you can omit the 'texhash'
  91. and 'ini' targets and simply run:
  92.   make config clean all
  93.   make install
  94.  
  95. Please note that calling make with an absolute path breaks the configure
  96. scripts.
  97.  
  98. The following example _does_not_work_:
  99.     /usr/local/bin/make world
  100.     ...
  101.     checking whether /usr/local/bin/make sets $MAKE... ./configure:
  102.     ${ac_cv_prog_make_/usr/bin/make_set+set}: bad substitution
  103.     ...
  104.  
  105. ============================================================================
  106.   7) final configuration steps
  107. ============================================================================
  108.  
  109. Overview:
  110.   - set up PATH
  111.   - check environment
  112.   - configure teTeX using texconfig
  113.  
  114. Set up PATH:
  115. ===========
  116. Set up your PATH to include the directory containing the just installed
  117. binaries (e.g. /usr/local/teTeX/bin/sparc-sunos4.1.3); similarly, MANPATH
  118. and INFOPATH to include the relevant newly installed subdirectories.
  119.  
  120. Check environment
  121. =================
  122. Note, that the run-time search paths for all programs that use
  123. the Kpathsea library can be configured by changing the paths in
  124. TETEXDIR/texmf.cnf and changes to these paths does not require to
  125. recompile any of the programs. Therefore, you hardly need to set extra
  126. environment variables. If you define some environment variables, they
  127. overrule the search paths in texmf.cnf unless they have an empty path
  128. component (i.e. a colon at the beginning or end or a doubled colon in
  129. the middle).
  130.  
  131. The variables to check are:
  132.   BIBINPUTS BSTINPUTS DVIPSHEADERS GFFONTS GLYPHFONTS MFBASES MFINPUTS
  133.   MFPOOL MPMEMS MPINPUTS MPPOOL MPSUPPORT PKFONTS TEXCONFIG TEXFONTS
  134.   TEXFORMATS TEXINPUTS TEXMFCNF TEXPICTS TEXPKS TEXPOOL TFMFONTS VFFONTS
  135.   DVIPSFONTS XDVIVFS XDVIFONTS DVILJFONTS TRFONTS
  136.  
  137. A simple way to check them is to run
  138.   texconfig confall
  139. once you have set up your PATH. Be careful if some variables are non-empty
  140. and have a look at the locations of the binaries. Not all binaries are
  141. checked, only some.
  142.  
  143. Configure teTeX using texconfig
  144. ===============================
  145. Texconfig allows you to set the defaults for hyphenation, paper size,
  146. print command, metafont mode, etc. You should run theis command
  147. interactively and see what options it offers.
  148.  
  149. =============================================================================
  150.  A) appendix: notes on some platforms
  151. =============================================================================
  152.  
  153. SGI-IRIX-6.0.1: (reported by bottoms@radar.nrl.navy.mil (Maitland Bottoms))
  154.     successfully compiled using:
  155.         CC=cc
  156.         CFLAGS=-O2 -s -32
  157.         LDFLAGS=-s -32
  158. HP-UX 10.10:
  159.     successfully compiled using:
  160.         CC     = cc
  161.         CFLAGS = -Ae +O3
  162.         INSTALL= bsdinst -c
  163.  
  164. AIX-4.2 (and newer?): set
  165.   override XINC    = --x-includes=/usr/include/X11
  166.   override XLIB    = --x-libraries=/usr/lib
  167.  
  168. Digital Unix 4.0: (and newer?) Add
  169.     -DPOINTER_IS_NOT_INT
  170.   to CFLAGS.
  171.  
  172. NEXTSTEP 3.x: (Gregor Hoffleit <flight@mathi.uni-heidelberg.de>)
  173.       - compile using GNU sed and GNU make
  174.       - normal compilation (one platform):
  175.         CC=cc in Makefile
  176.       - cross compilation (`FAT'):
  177.         CC=cc -arch m68k -arch i386 -arch hppa -arch sparc
  178.       - dvips on HP-PA: compile dvipsk/output.c without optimization
  179.         (no -O)!
  180.  
  181.       NOTE: there are some teTeX/NeXT specific files available via
  182.       ftp and on the web. The URLs are:
  183.         http://www.mathi.uni-heidelberg.de/~flight/stepTeX
  184.       and in the directory teTeX/contrib/NeXT on the ftp servers where
  185.       teTeX is available, e.g.:
  186.         ftp://ftp.dante.de/tex-archive/systems/unix/teTeX/contrib/NeXT
  187.  
  188.       You can find there a patch set that adds NeXTTeX IPC support to
  189.       the teTeX sources (-v, -V) and a TeXview.app with kpathsearch
  190.       support. The new TeXview.app can find the fonts files using
  191.       the same searching routines than all the other programs in
  192.       teTeX. The old one only works with a flat font directory structure
  193.       (i.e. all files in a single directory).
  194.         
  195.       See http://www.mathi.uni-heidelberg.de/~flight/stepTeX for further
  196.       instructions. ftp://zarquon.mathi.uni-heidelberg.de/pub/NeXT/TeX is
  197.       the primary site for the kpathsearch-TeXview.app and teTeX-NEXTSTEP
  198.       patches.
  199.