| 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 |
|