Debian Codegraph @

texmf-dist/doc/generic/enctex/INSTALL.eng

raw
1
2 EncTeX -- the extension of TeX based on tex.ch --- INSTALLATION
3 ===============================================================
4 1. Sep. 1997 Petr Ol\v s\'ak
5 3. Jan. 2003
6
7 For more information about encTeX -- read the README file.
8
9 You can install the encTeX extension with no problems on web2c
10 ver 7.3.
11
12 We describe the installation, if the original TeX was complied already or
13 if (at least) the ./configure script was run on web2c source tree and
14 the TeX libraries are installed in /usr/local/share/texmf.
15
16 1. Go to a directory with the tex.ch and tex.web files:
17
18 $ cd source/TeX/texk/web2c
19
20 2. Unpack enctex.tar.gz:
21
22 $ zcat /somewhere/enctex.tar.gz | tar xvf -
23
24 The ./enctex directory is created with files of the package.
25
26 3. Apply the patch to tex.ch file:
27
28 $ patch -p0 < ./enctex/enctex.patch-to-7.3.7
29
30 or
31
32 $ patch -p0 < ./enctex/enctex.patch-to-7.5
33
34 If you are using the web2c 7.4.5 or web2c 7.5.x then apply the
35 enctex.patch-to-7.5. If you are using web2c 7.5.x then you
36 can apply the second patch enc-option.patch-to-7.5. This second patch
37 implements the -enc commandline option (the encTeX is not
38 initialized without this option) and solves the cooperation with
39 TCX tables. The enctex.patch-to-7.5 and enc-option.patch-to-7.5
40 patches were sent to Olaf Weber in order to include the encTeX to
41 the standard web2c TeX distribution.
42
43 The next patch from encTeX Feb. 2003 to Jun. 2004 is recommended:
44
45 $ patch -p0 < ./enctex/enctex.patch-jun2004
46
47 If an error occurs in Hunk #1 then you have to replace text
48 "Feb. 2003" to new text "Jun. 2004" in file tex.ch manually.
49
50
51 4. Re-compile TeX:
52
53 $ make tex
54
55 The result is the new tex binary and tex.pool file.
56
57 5. Install the tex binary and tex.pool into the system (your paths may
58 be different from this example):
59
60 $ strip tex
61 $ su
62 # cp tex /usr/local/bin
63 # cp tex.pool /usr/local/share/texmf/web2c
64
65 6. Install the input tables of encTeX
66
67 # mkdir /usr/local/share/texmf/tex/generic/enctex
68 # cp enctex/*.tex /usr/local/share/texmf/tex/enctex
69 # texhash
70
71 7. Re-install the formats. The official version web2c-7.5.3 requires
72 the -enc option when format is generated (not required when format is
73 used). See the encdoc-e.tex|dvi|pdf for more information about
74 this option.
75
76 # cd /usr/local/share/texmf/web2c
77 # tex -ini -enc plain
78 *\dump
79 # tex -ini -enc csplain.ini
80 # mv csplain.ini.fmt csplain.fmt
81 # tex -ini -enc cslatex.ini
82 # mv cslatex.ini.fmt cslatex.fmt
83
84 If you want to try the new feature of the encTeX, you can inicialize some of
85 format plain-*-*.tex (see the enctex directory). For example:
86
87 # tex -i plain-1250-cs
88
89 8. The patched tex.ch is read by compilation process for tex, etex and
90 pdftex. You can recompile all these programs and the encTeX extension
91 will infect them succesfully. The enctex.patch-to-7.3 includes a
92 little patch to pdftexdir/tex.pch file in order to succesfull
93 compilation of pdftex. So, it is sufficient to do:
94
95 $ make pdftex
96 $ strip pdftex
97 $ su
98 # cp pdftex /usr/local/bin
99 # cp pdftex.pool /usr/local/share/texmf/web2c
100 # cd /usr/local/share/texmf/web2c
101 # pdftex -ini -enc -jobname pdfplain plain
102 *\dump
103 # pdftex -ini -enc -jobname pdfcsplain csplain.ini
104 # pdftex -ini -enc -jobname pdfcslatex cslatex.ini
105
106 9. The omega program is never infected by encTeX because it does not
107 read the tex.ch file during compilation. Omega has its own input
108 preprocessor.
109
110 --------------
111
112 The encTeX is installable on others than web2c implementation of TeX too.
113 All changes are made in tex.ch file. You can see to enctex.ch file (with
114 all changes of encTeX sumarized) and do the changes into your tex.ch
115 manually. There is only one problem here: I used the functions
116 dump_things/undump_things for dumping/undumping the xord, xchr and xprn
117 vectors to/from fmt file. These functions are the part of web2c libraries
118 only. If these functions are not available on your implementation, you must
119 rewrite the dumping using macros similar to dump_four_ASCII from
120 tex.web.
121