home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / tex / texsrc1 / Src / INSTALL < prev   
Encoding:
Text File  |  1993-02-16  |  5.2 KB  |  104 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 the file if
  4.    necessary.
  5.  
  6. 2. Edit `Makefile.in' if you want to make changes that will have effect
  7.    across different runs of `configure'.
  8.  
  9. 3. Do `sh configure' (or otherwise arrange for `configure' to be run
  10.    using the Bourne shell).
  11.    
  12.    You can control some of what configure does by setting environment
  13.    variables before running.  For example, configure normally uses gcc
  14.    if you have it, otherwise cc; but if the environment variable `CC' is
  15.    set, its value will be used.  Likewise for `YACC', `LEX', and `CCLD'.
  16.    
  17.    You can regenerate the `configure' script with the GNU Autoconf
  18.    distribution, available for ftp from prep.ai.mit.edu:pub/gnu, among
  19.    many other places.  You must arrange for the macros in ./aclocal.m4
  20.    to be seen by Autoconf.
  21.  
  22. 4. Inspect `./Makefile' and `lib/c-auto.h', which `configure' creates,
  23.    to see if configure's guesses were correct.  Change anything if
  24.    necessary; for example, if you want to optimize, change CFLAGS.
  25.    See ./MACHINES for possibly helpful information.
  26.    
  27. 5. `make triptrap' to build triptex and trapmf (and some of the other 
  28.    programs that are needed to run the tests).
  29.  
  30. 6. `make run-triptrap' to run the tests.  The differences (and many
  31.    error messages) will show up on your terminal.  If you have a
  32.    question about whether the differences are OK or not, consult
  33.    tex/TeXtrip/tripman.tex and mf/MFtrap/trapman.tex.  The most common
  34.    differences are in:
  35.    * glue setting being rounded differently in the TeX log;
  36.    * string space and maximum values of tables;
  37.    * the `down4' and `right4' commands in the dvitype output;
  38.    * the dates and times.
  39.    All these differences are acceptable.
  40.  
  41. 7. `make clean-triptrap' to get rid of the test programs and output.  You
  42.    need to do this before making the production versions, or the
  43.    resulting TeX and Metafont will have very small memories.
  44.  
  45. 8. `make' to make the working versions of the remaining programs.
  46.  
  47. 9. `make formats' to make the format files you want (the variable
  48.    `formats' in the Makefile defines the list).  If you don't know what
  49.    this means, see the section `Format files and preloading' below.
  50.    Before doing this, the TFM and other input files must be put in the
  51.    proper directories, and your search paths (e.g., the environment
  52.    variables TEXINPUTS, TEXFONTS, etc., or the defaults in Makefile.in if the
  53.    variables are unset) must look in those directories.
  54.  
  55. 10. `make bases' to make the base files for Metafont that you want.
  56.     Besides the variable `bases' in ./Makefile, you may also want to
  57.     change the variable `localmodes'.  It is also a good idea to try to
  58.     draw something online (if you intend to support that) before
  59.     installing Metafont, as this often fails to work right on the first
  60.     try.  See the `Running Metafont' chapter in the Metafontbook.  The
  61.     comments about search paths in #9 apply here, too.
  62.  
  63. 11. `make manpages' to edit the documentation in `man' for the paths and
  64.     constants you defined in `Makefile.in' and `c-auto.h.in'.
  65.  
  66. 12. `make install-exec' to install the programs.
  67.     `make install-formats install-bases' to install the formats/bases
  68.       and to create links to `virtex' and `virmf' for each.
  69.     `make install-manpages' to install the manual pages.
  70.     Alternatively, `make install' to install everything.
  71.  
  72. 13. There are several ``cleaning'' targets:
  73.     `mostlyclean' if you intend to compile on another
  74.       architecture.  Since the .c files are intended to be portable,
  75.       they are not removed.  If the lex/flex situation is going to be
  76.       different on the next machine, also rm web2c/lex.yy.c.
  77.     `clean' to remove everything that is normally created by compiling.
  78.     `distclean' to remove everything that would not be in a distribution. 
  79.     `realclean' to remove everything that the Makefiles can rebuild.
  80.     `extraclean' to remove `distclean' files plus other junk files.
  81.  
  82. If you wish to make just TeX or Metafont, the top-level Makefile has
  83. targets named `TeX' and `MF' which make {ini,vir}{tex,mf}, and nothing
  84. else. Similarly, if you don't want to (or can't) run both the trip and
  85. trap tests, `Makefile' has targets `run-trip' and `run-trap'.
  86.  
  87. If you wish to make just the C files (perhaps because you want to take
  88. them to another system), the top-level Makefile has a target `c-sources'.
  89.  
  90. If you are installing TeX for the first time, the files here are not
  91. nearly enough.  You will also need all the TeX and Metafont macro files,
  92. and the font sources.  (Not to mention drivers for your output devices.)
  93. All of these things are part of the Unix TeX distribution, which you can
  94. order from the University of Washington (send email to
  95. elisabet@u.washington.edu).  The web2c distribution itself originates
  96. from ftp.cs.umb.edu.  See the file `FTP' for information on where to
  97. retrieve a minimal TeX setup electronically.
  98.  
  99. The host labrea.stanford.edu is the ultimate source for those files
  100. still maintained by Knuth (for example, plain.tex).  Another ftp site
  101. with a large collection (including copies of what is on labrea) is
  102. ftp.tex.ac.uk.  The Aston archive in England makes things available by
  103. email; the address is texserver@tex.aston.ac.uk.
  104.