diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/multitex.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/base/multitex.txt | 198 |
1 files changed, 198 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/multitex.txt b/Master/texmf-dist/doc/latex/base/multitex.txt new file mode 100644 index 00000000000..9bfa5e33612 --- /dev/null +++ b/Master/texmf-dist/doc/latex/base/multitex.txt @@ -0,0 +1,198 @@ + LaTeX installation instructions for MultiTeX + + 10 January 1998 + +SUMMARY +======= + +This file contains instructions on how to install LaTeX for MultiTeX on +TOS, MiNT or MagiC. + +Before reading this file, you should read install.txt, which will +explain how the LaTeX installation works. + +This file describes: + + * What do you need. + + * How to save any old version of LaTeX. + + * How to unpack the LaTeX distribution. + + * How to create the LaTeX format. + + * How to install the LaTeX files. + +These instructions assume that you are using the standard directory set +up supplied by the MultiTeX distribution. We hope that, if your system's +set up differs from this then you will be sufficiently familiar with +your system to make the necessary amendments to these instructions. + + +WHAT DO YOU NEED +================ + +You need MultiTeX with a TeX version 3.141. If you don't know the version +doubleclick TEX_L.TTP and INITEX_L.TTP. This will show you the version. + +If the version is 3.14 or less, you should update TeX. You can find version +3.141 at the CSTEX bundle on CTAN (systems/atari). + +Only use filenames at the 8+3 scheme, sometimes MultiTeX produces nice errors +using long or case sensitive filenames! If you are using a case sensitive +filesystem, use only lowercase, because MultiTeX-programs do some changes to +lowercase! I use uppercase in this documentation because Atari does so +traditionally. + + +SAVING YOUR OLD VERSION OF LaTeX +================================ + +If you are currently using the old LaTeX version, 2.09, you may wish +to save it before installing the new version of LaTeX. + +You should make a subdirectory calles latex209 in the MultiTeX directory +(e.g. ...\TEX\LATEX209). Then copy the subdirectories with the styles +and with other input files (normaly STYLES, INPUTS and INITEX) into this +latex209 subdirectory. You should also rename the LaTeX format file +which you use for LaTeX 2.09 (usually latex.fmt into latex209.fmt, +latex.fml into latex209.fml, latexg.fmt into latxg209.fmt and +latexg.fml into latxg209.fml). + + +BEFORE UNPACKING THE DISTRIBUTION +================================= + +You should create some new subdirectories: + ...\TEX\LATEX + ...\TEX\LATEX\BASE + ...\TEX\LATEX\UNPACKED + +Latex needs a number of files to run, for example `article.cls' +contains the `article' document class. However, these files are NOT +themselves the source files produced by the LaTeX3 Project Team. We +write documented sources in `docstrip archive files' which can be +unpacked to produce the files that LaTeX needs. For example, +classes.dtx contains the documented sources for all the LaTeX +document classes, including article.cls. + +The FIRST thing to do is to check whether you need to unpack these +archive files, as follows. + +Before reading any further, you should check to see whether the LaTeX +distribution you have contains the unpacked files. You can do this by +looking to see if you have got the file latex.ltx. If you do, then +you should have all the unpacked files and so you can move on to the +section entitled `Creating the LaTeX format'. + + +UNPACKING THE DISTRIBUTION +========================== + +The unpacking will create and write files into the current TEXOUTPUTS +directory. This helps to prevent it overwriting existing files or +causing problems with your system files. You should set TEXOUTPUTS at +the TeX-Shell (TSH) to ...\TEX\LATEX\UNPACKED (menu entry "Parameter|... TeX"). +Set TEXINPUTS to ".;...\TEX\LATEX\BASE" (iff you find UNPACK.INS at another +directory add this instead of "...\TEX\LATEX\BASE" to ".;" or copy all files at +the directory of UNPACK.INS to ...\TEX\LATEX\BASE). + +The archive files are unpacked by running iniTeX (INITEX.TTP) on the +file unpack.ins. To do this select menu entry "TeX-Projekt|Erzeugen" +and select UNPACK.INS at the file-selector (you have to change "*.INI" at the +file-selector-mask to "*.INS" or "*.*"). + +Note: Using an ATARI ST with 8Mhz this will take about 3-4 hours! + + +CREATING THE LATEX FORMAT +========================= + +You should edit the file TEX_L.OPT at the ...\TEX\FORMATS subdirectory. +Setup the variables to following values: + mem_max=100000 + pool_size=65000 + trie_size=18000 + font_mem_size=34000 +If you have more than 2MB, you may set mem_max to an greater value (e.g. 120000 +or 204800. If you only use english hyphenation pattern, you may set trie_size +to 16000 only. If you use many hyphanation pattern, you should set trie_size to +a value greater than 18000. + +Setup the Shell to use TEX_L.TTP instead of TEX.TTP and INITEX_L.TTP +instead of INITEX.TTP (menu entry "Parameter|... TeX") or the TT-Versions of +these programms. + +Set TEXINPUTS to ".;...\TEX\LATEX\*" (iff you find LATEX.LTX at another +directory add this to TEXINPUTS too, or copy all files at the directory of +LATEX.LTX to ...\TEX\LATEX\UNPACKED). + +To create the LaTeX format, you should run iniTeX on the file +`latex.ltx'. Call menu entry "TeX-Projekt|Erzeugen" and select +LATEX.LTX. + +A hyphenation file such as `hyphen.tex' is read by this run so it +should be accessible by iniTeX. It also needs to be able to read the +`.tfm' font files for the basic fonts. These font files and +hyphenation file(s) should be part of your TeX system (see also INSTALL.TXT) + +If you want e.g. german-hyphenation-pattern read the documentation of +german or babel package (you should put hyphen.cfg, ghyph31.tex and for babel +language.dat to ...\TEX\LATEX or a subdirectory). + +As result you will get a format file `latex.fml' in the +FORMATS-directory. Enter menu entry "Tex-Projekt|Einstellungen" and set +"Format-Vorgabe:" to "latex" or "LATEX". + + +PUTTING THE FILES WHERE LaTeX CAN READ THEM +=========================================== + +Setup the TEXINPUTS-Variable at menu entry "Parameter|... TeX" to +".;...\TEX\LATEX\*" (don't write "...\TEX", write the hole name of your +own TeX-directory, e.g. ".;F:\TEX\LATEX\*"). Setup the additional +TEXINPUTS-Path (after "+") to the directory, you saved your old +LaTeX2.09 to (if you have done). + +If LATEX.LTX and/or TEXSYS.CFG not at ...\TEX\LATEX or a subdirectory of this, +add there directory to TEXINPUTS. + +Setup the TEXOUTPUS-Variable at menu entry "Parameter|... TeX" to your +TeX-output-directory (e.g. "F:\TEX\OUTPUTS" or simply "."). + +You have now installed LaTeX! + + +CHECKING THAT THE INSTALLATION WORKED +===================================== + +To make sure that the installation has worked, you should run the new +LaTeX on the document `ltxcheck.tex'. + +Copy LTXCHECK.TEX to your TEXOUTPUTS-directory. Select LTXCHECK.TEX at +your TEXOUTPUTS-directory as main-document (menu entry +"TeX-Projekt|Hauptdatei") and call TeX (menu entry "Arbeiten|TeX"). + +This will produce a number of messages, each of which should be `OK'. +If any of them are `BAD', then read the notes in texpert.txt. + +If all the messages are `OK' then you are finished! + +Note: If you run LTXCHECK.TEX at another directory than TEXOUTPUTS, + ltxcheck will report not existing errors. + +FINALLY +======= + +Note: If you want to process a *.dtx-file. You have to select it as + main-file and call TeX. Unfortunately the shell deletes the + extension "dtx". So TeX searches for a *.tex-file, cannot find + it and asks for the correct filename. You have to type in the + filename (with extension "dtx") once more. + If you want to call (La)TeX with doubleclick to a *.tex- or + *.dtx-file (without typing in the name twice), you may use the + calltex-program. + + +Copyright 1998 Markus Kohm and the LaTeX3 project. + |