← Back to branch summary

~ubuntu-branches/ubuntu/utopic/texlive-bin/utopic

« back to all changes in this revision

Viewing changes to texk/web2c/etexdir/INSTALL

  • Committer: Package Import Robot
  • Author(s): Norbert Preining
  • Date: 2012-05-07 10:47:49 UTC
  • mfrom: (1.2.4)
  • Revision ID: package-import@ubuntu.com-20120507104749-p00ot5sajjbkp1hp
Tags: 2011.20120507-1
* new upstream checkout: uptex 1.10
* drop patches for config file inclusion in (x)dvipdfmx, included upstream
* add man page for etex
* include pmpost patches and build it
* adapt/unfuzzify patches for current sources
* disable mtx building, we have prepmx package in Debian

Show diffs side-by-side

added added

removed removed

Lines of Context:
texk/web2c/etexdir/INSTALL
1
 
Contents:
2
 
 
3
 
Installation
4
 
  Additional `configure' options
5
 
  Additional targets
6
 
  Trip, etrip, trap, and mptrap: Torture tests
7
 
 
8
 
 
9
 
Installation
10
 
************
11
 
 
12
 
  Installing e-TeX requires that you have already installed the Web2c
13
 
source tree (either `web-7.2.tar.gz' and `web2c-7.2.tar.gz' with
14
 
`web2c-7.2' as top-level directory, or `texk-7.2.tar.gz' with `texk-7.2').
15
 
See web2c/INSTALL for details.
16
 
 
17
 
Unpack the distribution file `web2c-7.2-etex-2.0.tar.gz' in the parent of
18
 
the top-level directory. If necessary move the directory
19
 
`<top_level>/web2c/etexdir' containing all e-TeX files into your source
20
 
tree. Then (re-)configure the whole source tree.
21
 
 
22
 
You will also need some e-TeX specific files in the TDS tree. Change to
23
 
to the TDS root (`<texmf>') and unpack the distribution file
24
 
`etexlib-2.0.tar.gz'. If you have already installed an earlier version,
25
 
first remove the directory `<texmf>/etex' containing all the old files.
26
 
 
27
 
Additional `configure' options
28
 
==============================
29
 
 
30
 
  This section describes only the e-TeX specific `configure' options,
31
 
for the general Web2c `configure' options see `../INSTALL'.
32
 
 
33
 
`--without-etex'
34
 
`--with-etex=no'
35
 
     Do not automatically generate and install e-TeX and e-TeX formats
36
 
     (as part of `make' resp. `make install').
37
 
 
38
 
`--with-etex=yes'
39
 
`--with-etex=etex'
40
 
     Automatically generate and install e-TeX and e-TeX formats (in
41
 
     extended mode) in addition to TeX and TeX formats. This is the default.
42
 
 
43
 
`--with-etex=tex'
44
 
     Automatically generate e-TeX and e-TeX formats (in compatibility as
45
 
     well as extended mode) and install them, using e-TeX instead of TeX.
46
 
     Do not install TeX and TeX formats.
47
 
 
48
 
Additional targets
49
 
==================
50
 
 
51
 
  e-TeX adds some new Web2c Make targets and the e-TeX specific `configure'
52
 
options described above influence the behaviour of some other targets.
53
 
 
54
 
`formats'
55
 
`install-formats'
56
 
     Make or install all the memory dumps (*note Memory dumps::.).  By
57
 
     default, the standard plain formats plus `latex.fmt' or `latex.efmt'
58
 
     plus possibly `elatex.efmt' are made.  The `latex.efmt' is in e-TeX
59
 
     compatibility mode, to be used when e-TeX is installed instead of TeX;
60
 
     the `elatex.efmt' is in extended mode.  You can add other formats by
61
 
     redefining the `fmts', `cfmts', `efmts', `bases', and `mems' variables.
62
 
     See the top of `web2c/Makefile' for the possibilities.
63
 
 
64
 
`triptrap'
65
 
`trip'
66
 
`etrip'
67
 
`trap'
68
 
`mptrap'
69
 
     To run the torture tests for TeX, e-TeX, Metafont, and MetaPost
70
 
     (respectively).  See the next section.
71
 
 
72
 
Trip, etrip, trap, and mptrap: Torture tests
73
 
============================================
74
 
 
75
 
  To validate your TeX and/or e-TeX, Metafont, and MetaPost executables,
76
 
run `make triptrap'.  This runs the trip and/or etrip, trap, and mptrap
77
 
"torture tests".  See the files `triptrap/tripman.tex', 
78
 
`etexdir/etrip/etripman.tex', `triptrap/trapman.tex', and
79
 
`triptrap/mptrap.readme' for detailed information and background on the
80
 
tests.
81
 
 
82
 
  The differences between your executables' behavior and the standard
83
 
values will show up on your terminal.  See the file `./INSTALL' for the
84
 
acceptable differences.
85
 
 
86
 
  The files `trip.diffs', `mftrap.diffs', and `mptrap.diffs' in the
87
 
`triptrap' directory and `etexdir/etrip/etrip.diffs' show the standard diffs
88
 
against the original output.  If you diff your diffs against these files,
89
 
you should come up clean.  For example
90
 
     make etrip >&myetrip.diffs
91
 
     diff etexdir/etrip/etrip.diffs myetrip.diffs
92
 
 
93
 
  To run the tests separately, use the targets `trip', `etrip', `trap', and
94
 
`mptrap'.  Warning: with the `configure' option `--without-etex' the target
95
 
`etrip' will cause Make to first generate the e-TeX executable; similarly
96
 
with the `configure' option `--with-etex=tex' the target `trip' will cause
97
 
Make to first generate the TeX executable.
98