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