summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/enctex/INSTALL
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:56:57 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:56:57 +0000
commitf07bb53970ee2ecc53f81a206a3d3a67ef665e4a (patch)
tree6f57a1d62971db79e5ff023bdfd83b22cb971dc9 /Master/texmf-dist/doc/generic/enctex/INSTALL
parent007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (diff)
doc 6
git-svn-id: svn://tug.org/texlive/trunk@85 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/enctex/INSTALL')
-rw-r--r--Master/texmf-dist/doc/generic/enctex/INSTALL131
1 files changed, 131 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/enctex/INSTALL b/Master/texmf-dist/doc/generic/enctex/INSTALL
new file mode 100644
index 00000000000..aa3d949725a
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/enctex/INSTALL
@@ -0,0 +1,131 @@
+
+ EncTeX -- rozšíření TeXu o možnost překódování -- popis instalace
+ =================================================================
+ 1. 9. 1997 Petr Olšák
+ 3. 1. 2003
+
+Nejprve popíšu postup při instalaci encTeXu na web2c verze 7.3, kde již
+původně byl originální program TeX kompilován, nebo byl aspoň spuštěn
+configure (podle pokynů pro instalaci web2c TeXu) a jsou připraveny
+knihovny TeXu (*.tfm, *.tex apod.) v /usr/local/share/texmf.
+
+V balíku jsou dodáván patch pro verzi web2c 7.3.7
+
+1. přejdeme do adresáře, kde je tex.ch a tex.web:
+
+ $ cd source/TeX/texk/web2c
+
+2. Rozbalíme enctex.tar.gz:
+
+ $ zcat /zdroj/enctex.tar.gz | tar xvf -
+
+3. Aplikujeme změnu souboru tex.ch:
+
+ $ patch -p0 <./enctex/enctex.patch-to-7.3.7
+
+ nebo
+
+ $ patch -p0 <./enctex/enctex.patch-to-7.5
+
+ v závislosti na verzi web2c, kterou máme.
+ Soubor enctex.patch-to-7.5 je možné použít i na web2c 7.4.5,
+ což byla aktuální stabilní verze teTeXu.
+
+ Pokud máte verzi web2c 7.5, pak můžete navíc
+ po aplikaci tohoto patche použít ještě patch
+ enc-option.patch-to-7.5, který přidává přepínač -enc do
+ příkazového řádku (bez něho není encTeX inicializován) a
+ řeší spolupráci s TCX tabulkami. Tato dvojice patchů byla zaslána
+ Olafu Weberovi k zařazení do standardní distribuce web2c.
+
+ Doporučuji přejít z verze encTeXu Feb. 2003 na verzi Jun. 2004,
+ která opravuje některé chyby:
+
+ $ patch -p0 <./enctex/enctex.patch-jun2004
+
+ Pokud tento krok ohlásí chybu pro Hunk #1, je potřeba v souboru
+ tex.ch nahradit řetězec "Feb. 2003" textem "Jun. 2004" manuálně.
+ Ostatní části záplaty (hunks) by měly projít bez problémů.
+
+4. Překompilujeme TeX:
+
+ $ make tex
+
+Tento povel v sobě zahrnuje jednak
+tangle tex.web tex.ch
+což vytvoří Pascalský kód TeXu tex.p. Dále se provede
+./web2c/convert tex.p
+takže vznikají jednotlivé moduly tex?.c v jazyce C. Potom se tyto moduly
+kompilují kompilátorem jazyka C a nakonec linkují do spustitelného programu
+tex. Výsledkem je tedy nový program tex a dále nový inicializační soubor
+tex.pool.
+
+5. Instalujeme binární program tex a soubor tex.pool do systému
+(cesty se ve Vašem systému mohou mírně lišit):
+
+ $ strip tex
+ $ su
+ # cp tex /usr/local/bin
+ # cp tex.pool /usr/local/share/texmf/web2c
+
+6. Instalujeme vstupní tabulky *.tex z balíku encTeX. Doporučuji je zařadit
+do adresáře enctex:
+
+ # mkdir /usr/local/share/texmf/tex/generic/enctex
+ # cp enctex/*.tex /usr/local/share/texmf/tex/generic/enctex
+ # texhash
+
+7. Inicializujeme znovu formáty. Pro verzi encTeXu z oficiální
+web2c-7.5.3 je nutné použít při generování formátů (nikoli při použití
+formátu) přepínač -enc. Význam tohoto přepínače je vysvětlen
+v dokumentaci encdoc.tex|dvi|pdf.
+Příklady proto uvádím s tímto přepínačem.
+
+ # cd /usr/local/share/texmf/web2c
+ # tex -ini -enc plain
+ *\dump
+ # tex -ini -enc csplain.ini
+ # tex -ini -enc -jobname cslatex cslatex.ini
+
+Pokud chcete hned využít nových vlastností TeXu, zkuste instalovat
+některý z formátů plain-x-y, například:
+
+ # tex -ini -enc plain-1250-cs
+
+Viz soubory enctex/plain-*-*.tex a enctex/kam-latex.tex.
+
+8. Pozměněný tex.ch čte tangle i při kompilaci programů pdftex a
+etex. Tyto programy budou tedy po kompilaci také obsahovat encTeX.
+Při požití enctex.patch-to-7.3 se kromě tex.ch pozměnil v drobné
+maličkosti i soubor pdftexdir/tex.pch, což je nutné pro zdárnou
+kompilaci. Stačí tedy vytvořit pdftex obvyklým způsobem:
+
+ $ make pdftex
+ $ strip pdftex
+ $ su
+ # cp pdftex /usr/local/bin
+ # cp pdftex.pool /usr/local/share/texmf/web2c
+ # cd /usr/local/share/texmf/web2c
+ # pdftex -ini -enc -jobname pdfplain plain
+ *\dump
+ # pdftex -ini -enc -jobname pdfcsplain csplain.ini
+ # pdftex -ini -enc -jobname pdfcslatex cslatex.ini
+
+9. Program Omega není encTeXem pozměněn, protože při své kompilaci
+nenačítá tex.ch. Taky by to nemělo žádnou logiku, protože omega má
+svůj vlastní konfigurovatelný input procesor.
+
+--------------
+
+Protože encTeX pozměňuje pouze velmi málo věcí ve změnovém souboru
+tex.ch, je možné jej při troše ruční práce instalovat i na jiných
+implementacích TeXu, kde jsou k dispozici zdrojové texty TeXu tex.web
+a tex.ch. Stačí se podívat do souboru enctex.ch, kde je patrné, jaké
+změny se mají provést. Veškerý kód encTeXu se opírá o standardní
+části programu tex.web s výjimkou ukládání vektorů xord a xchr do
+formátu. Zde jsem s výhodou použil již hotové pomocné funkce
+dump_things a undump_things napsané pro web2c přímo v jazyce C. Pokud
+by to někdo potřeboval v jiné implementaci, musel by zřejmě použít
+analogii k dump_four_ASCII z tex.web.
+
+