summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/multitex.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/multitex.txt')
-rw-r--r--Master/texmf-dist/doc/latex/base/multitex.txt198
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.
+