home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / unixtex-6.1b-src.tgz / tar.out / contrib / unixtex / web2c / INSTALL < prev    next >
Text File  |  1996-09-28  |  5KB  |  106 lines
  1. Here is the procedure for getting things running.
  2.  
  3. 1.  Inspect the first section of `lib/c-auto.h.in', and edit if necessary.
  4.  
  5. 2a. Edit `Makefile.in' if you want to make changes that will have effect
  6.     across different runs of `configure'; for example, changing the
  7.     installation directories. Alternatively, override the make
  8.     variables on the command line when you run make.
  9.  
  10. 2b. Edit `kpathsea/paths.h.in' to define your local paths. If you do not
  11.     change these paths, it is possible that your TeX will start up 
  12.     Very, Very, Slowly. Or the programs won't find any of your fonts or
  13.     other input files. See kpathsea/INSTALL for more details on changing
  14.     the default paths.
  15.  
  16. 3. Do `sh configure' (or otherwise arrange for `configure' to be run by
  17.    a Bourne-compatible shell).  If you want to change the prefix or
  18.    exec_prefix make variables, give the -prefix and -exec-prefix options
  19.    to configure.  By default, the prefix is the parent directory of the
  20.    directory where the program `tex' is found, or /usr/local.
  21.    
  22.    You can control some of what configure does by setting environment
  23.    variables before running.  For example, configure normally uses gcc
  24.    if you have it, otherwise cc; but if the environment variable `CC' is
  25.    set, its value will be used.  Likewise for `YACC', `LEX', and `CCLD'.
  26.  
  27. 4. Inspect `./Makefile' and `lib/c-auto.h', which `configure' creates,
  28.    to see if configure's guesses were correct.  Change whatever is
  29.    necessary; for example, if you want to optimize, change CFLAGS.
  30.    See ./MACHINES for possibly helpful information.
  31.    
  32. 5. `make triptrap' to build triptex and trapmf (and some of the other 
  33.    programs that are needed to run the tests).
  34.  
  35. 6. `make run-triptrap' to run the tests.  The differences (and many
  36.    error messages) will show up on your terminal.  If you don't know
  37.    whether the differences are OK or not, consult tex/TeXtrip/tripman.tex
  38.    and mf/MFtrap/trapman.tex.  The usual differences are
  39.    * glue setting being rounded differently in the TeX log;
  40.    * string usage and maximum values of tables;
  41.    * the `down4' and `right4' commands in the dvitype output;
  42.    * the dates and times.
  43.    All these differences are acceptable.
  44.  
  45. 7. `make clean-triptrap' to get rid of the test programs and output.  You
  46.    need to do this before making the production versions, or the
  47.    resulting TeX and Metafont will have very small memories.
  48.  
  49. 8. `make programs' to make the working versions of the remaining programs
  50.    Alternatively. `make all' combines `programs', `formats', and `manpages'.
  51.  
  52. 9. `make formats' to make the TeX fmts and Metafont bases (the Make
  53.    variables `fmts' and `bases' define the list).  If you don't know
  54.    what this means, see the section `Format files and preloading' below.
  55.    
  56.    Before doing this, the basic .tfm, .tex, and .mf files must be
  57.    installed, and your search paths (e.g., the environment variables
  58.    TEXINPUTS, TEXFONTS, etc., or the compile-time defaults in
  59.    kpathsea/paths.h.in if the variables are unset) must look in those
  60.    directories.  Also check the value of the localmodes Make variable.
  61.    
  62.    If you don't have the tfm/tex/mf files, see the file
  63.    ftp.cs.umb.edu:pub/tex/FTP.nwc (which also contains tape ordering
  64.    information). (This file is not included in the distribution because
  65.    it changes far more frequently than web2c.)
  66.    
  67.    You can `make fmts' and `make bases' separately if you prefer.
  68.  
  69. 10. `make manpages' to edit the documentation in `man' for the paths and
  70.     constants you defined in `Makefile.in' and `c-auto.h.in'.
  71.  
  72. 11. `make install-exec' to install the programs.
  73.     `make install-formats install-bases' to install the formats/bases
  74.       and to create links to `virtex' and `virmf' for each.
  75.     `make install-manpages' to install the manual pages.
  76.     `make install-data' to do install-formats install-bases install-manpages,
  77.       and to get the pool files and other architecture-independent files.
  78.     Alternatively, `make install' to install everything.
  79.  
  80. 12. There are several targets for cleanup:
  81.     `mostlyclean' if you intend to compile on another
  82.       architecture.  Since the .c files are intended to be portable,
  83.       they are not removed.  If the lex/flex situation is going to be
  84.       different on the next machine, also rm web2c/lex.yy.c.
  85.     `clean' to remove everything that is normally created by compiling.
  86.     `distclean' to remove everything that would not be in a distribution. 
  87.     `realclean' to remove everything that the Makefiles can rebuild.
  88.     `extraclean' to remove other junk.
  89.  
  90. If you wish to make a single program, the top-level Makefile has
  91. targets `TeX', `MF', and `BibTeX'. (No targets for the other programs, though.)
  92.  
  93. If you don't want to (or can't) run both the trip and trap tests,
  94. `Makefile' has separate targets `run-trip' and `run-trap', and
  95. `clean-trip' and `clean-trap'.
  96.  
  97. If you wish to make just the C files (perhaps because you want to take
  98. them to another system), the top-level Makefile has a target `c-sources'.
  99.  
  100. The host labrea.stanford.edu is the ultimate source for those files
  101. maintained by Knuth (for example, plain.tex).  But do not use labrea for
  102. any other files! It is very often out of date.
  103.  
  104. I strongly suggest using flex and bison (version 2.4.6 and 1.22 were
  105. current as of this writing) for lex and yacc.
  106.