diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/decustex.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/base/decustex.txt | 373 |
1 files changed, 0 insertions, 373 deletions
diff --git a/Master/texmf-dist/doc/latex/base/decustex.txt b/Master/texmf-dist/doc/latex/base/decustex.txt deleted file mode 100644 index 323d00f1b03..00000000000 --- a/Master/texmf-dist/doc/latex/base/decustex.txt +++ /dev/null @@ -1,373 +0,0 @@ - LaTeX installation instructions for DECUS TeX (OpenVMS) - - 15 August 1994 - - -SUMMARY -======= - -This file contains instructions on how to install LaTeX for -DECUS TeX on OpenVMS. Before reading this file, you should read -install.txt, which will explain how the LaTeX installation works. - -This file describes: - - * How to save any old version of LaTeX. - - * How to unpack the LaTeX distribution. - - * How to configure LaTeX. - - * How to create the LaTeX format. - - * How to install the LaTeX files. - - * How to check the LaTeX installation. - - * Post Installation Tasks. - - * Running LaTeX with old versions (PD V3.4 and earlier) of DECUS TeX - - -SAVING ANY 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. - -a) The old LaTeX 2.09 version will be kept in a subdirectory [.LATEX209] - in your TeXinputs tree (normally TEX_ROOT:[INPUTS]). - - When your LaTeX distribution was already installed in a subdirectory - (e.g. [.LATEX]), simply execute a rename: - RENAME TEX_ROOT:[INPUTS]LATEX.DIR LATEX209.DIR - (You may have to modify the file protection of the directory file.0 - - Otherwise, create a new subdirectory TEX_ROOT:[INPUTS.LATEX209] - All style files (.STY) as well as LATEX.TEX, LPLAIN.TEX, LFONTS.TEX, - SLITEX.TEX, SPLAIN.TEX, SFONTS.TEX, LHYPHEN.TEX, IDX.TEX, LABLST.TEX, - MAKEINDEX.TEX, SAMPLE.TEX, SMALL.TEX, TRYFONTS.TEX, TESTPAGE.TEX and - TESTA4.TEX should be moved into this directory. - -b) You need to set up a separate logical name for the LaTeX-2.09 search - list; to prevent interference with the new LaTeX release: - Edit the command procedure that is used to initialize the TeX system: - This is probably the file STARTTEX.COM, located in TEX_ROOT:[000000]. - Search for the definition of the TEX_INPUTS search list. Add a similar - definition using another name (.e.g. LTX_INPUTS) by duplicating the - search list in STARTTEX.COM. Change this new definition by adding - an entry "TEX_ROOT:[INPUTS.LATEX209]" at the top of the list, so - that the files from the old LaTeX-2.09 are accessed before the new files - from LaTeX2e. - -c) To use the old LaTeX 2.09 format, you have to define a new command - which uses the new logical name LTX_INPUTS as TeXinputs search path. - This is archived by adding the following line to STARTTEX.COM (best - place: just after the INITEX command definition): - - "$ OLATEX :== TEX/FORMAT=TEX_FORMATS:LPLAIN/TEXINPUTS=LTX_INPUTS:" - -d) There is no need to rename the old format file LPLAIN.FMT. The new LaTeX - format uses a different name (LATEX.FMT) per default. - But if there is a command procedure to generate the format files, you - might want to update it to reflect the changed location of the LaTeX-2.09 - sources. - -To install the recent changes, you have to reexecute the TeX initialization -procedure. To enshure that all logical names are properly redefined, you -should delete the logical name TEX_ROOT by - "DEASSIGN TEX_ROOT" -(or simply log out and start a new session). - - -UNPACKING THE DISTRIBUTION -========================== - -It is recommended that you keep the new LaTeX distributions an a -separate subdirectory. This simplifys later maintance work. -To unpack the sources, you should create a new directory, e.g: -TEX_ROOT:[INPUTS.LATEX.SRC]. -Copy the hole LaTeX distribution into this directory, and change -your working directory to this location with a SET DEFAULT command. -Now simply type - "INITEX UNPACK.INS" -(after you have initialized the TeX system). The unpack procedure -should then proceed without errors. -The time needed for Unpacking depends on your hardware equipment. -On an Alpha AXP machine (DEC 3000/400), this will last less than 5 minutes; -on an older VAX, you will probably need an order of magnitude more time. -(But I have never tested it on a VAX...) - - - -CONFIGURING LATEX -================= - -A) The TEXSYS.CFG file: ------------------------ -If you have a recent version of DECUS TeX (3.1415, PD V3.5 or later), no -special texsys.cfg file is needed. DECUS TeX is now fully compatible with -the extended input checking techniques used in the new LaTeX (LaTeX2e). -For a usable texsys.cfg setup with older (outdated) versions of DECUS TeX, -see the section -"Running LaTeX with old versions (PD 3.4 and earlier) of DECUS TeX" -below. - -B) Setting up multilingual hyphenation patterns: ------------------------------------------------- -If you want to use non USenglish hyphenation patterns (in addition -or as a replacement), you need to create a configuration file -"HYPHEN.CFG" to override the LaTeX defaults. -Your HYPHEN.CFG file should load all required hyphenation patterns. -At the end, the default language should be switched on and the appropiate -values of \lefthyphenmin and \righthyphenmin for this language should be -set. -It is strongly recommended to load the USenglish hyphenation patterns -as language 0 and to use this language as default to maintain compatibility -with other installations. This setup is needed to allow correct processing -of the delivered (english) LaTeX documentation files! -As an example for a HYPHEN.CFG file, a bilingual setup for german -and US english (can be used together with the babel package or german.sty) -is shown: -%% -%% This is file `hyphen.cfg', -%% -%% Modified for dual language support by Christian Spieler, 20. June 1994. -%% -%% This file is part of the LaTeX2e system. -%% ---------------------------------------- -%% - -\message{Loading hyphenation patterns for US english and German.} - -% PREPARING A FOREIGN LANGUAGE VERSION: -% -% This file loads hyphenation patterns for US english. -% If you want to load additional or other hyphenation patterns, -% you have to change this file, which is hereby allowed explicitly, -% under the restriction that if you do so, you MUST also change the -% message above. -% - -\message{US-English hyphenation} - \language=0 - \chardef\l@USenglish=\language - \input ushyphen \input ushyphen.upd - -\message{German hyphenation} - \newlanguage\l@german - \language=\l@german - \input ghyphen - -\language=\l@USenglish % USenglish as Default -\lefthyphenmin=2 \righthyphenmin=3 % disallow x- or -xx breaks -\endinput -%% -%% End of file `hyphen.cfg'. - -For a nongerman country, the needed modifications are obvious. -Further information can be found in "texpert.txt" and "lthyphen.dtx". - -C) Memory requirements: ------------------------ -LaTeX2e needs more main memory, string memory and hash space to -store its macros than previous versions of LaTeX. -Since DECUS TeX is compiled as (64 bit) BigTeX with large memory arrays, -this should not impose any problems. -When you have got a newer version of DECUS TeX (3.1415 PD 3.3a or later) -there should be enough pattern memory to load at least hyphenation patterns -for three different languages. The sizes of the current version (PD 3.5) -are: - trie size: 45000 - trie op size: 1000 - trie op size per language: 511 - -The bad news: -Up to now, DECUS TeX does not allow to adjust its internal arrays at -run time. Therefore, if you really need more space somewhere, you -have to recompile TeX -- the program -- with the appropiate changes, -sorry. - - - -CREATING THE LaTeX FORMAT -========================= - -Be sure that all hyphenation pattern sources requested by HYPHEN.CFG -are accessible through the TEX_INPUTS search list. When you did not -create a HYPHEN.CFG file, at least the US english hyphenation pattern -must be found this way under the name HYPHEN.TEX. - -To create the LaTeX format the first time, you should apply -the command: - - initex latex.ltx - -in the directory where you have unpacked the distribution. -This will create a file LATEX.FMT in this directory without -further interaction. - -This file has to be moved to the formats directory to be accessible -by the LATEX command. This can be archived by - - RENAME LATEX.FMT TEX_FORMATS: - SET FILE/PROTECTION=(W:RE) TEX_FORMATS:LATEX.FMT - -(If TEX_FORMATS: is located on a different disk in your installation, -you have to use the COPY command, instead. The protection setting enables -all users to use the new format.) - - - -PUTTING THE FILES WHERE LaTeX CAN READ THEM -=========================================== - -The LaTeX class and style files as well as some auxiliary .TEX files -need to be put in a directory of the TEX_INPUTS search path. In the -suggested setup, this is simply the parent directory of the location -where you have unpacked the distribution. -You should apply: - - RENAME latexbug.tex, testpage.tex, docstrip.tex, - - lablst.tex, idx.tex, nfssfont.tex, small2e.tex, sample2e.tex, - - *.cls, *.clo, *.sty, *.fd, *.def, *.ist [-] - - - -FINAL INSTALLATION STEPS -======================== - -To use LaTeX, some preparations need to be done: - -1.) You have to enshure that TeX looks into the right directories when - searching for LaTeX styles and classes. In the suggested setup, - the LaTeX core classes and styles have been put into the directory - TEX_ROOT:[INPUTS.LATEX]. This directory needs to be part of the - Texinputs search list, which is (normally) defined by the logical - name TEX_INPUTS (without colon!). Check the TeX startup command file - STARTTEX.COM (should be found in TEX_ROOT:[000000]). The list of - equivalences in the definition of "TEX_INPUTS" should contain the - directory where you intend to place the LaTeX2e classes. For correct - operation, it is ABSOLUTELY neccessary that this directory is listed - before any location of old LaTeX-2.09 files! - (For efficiency, it might be best to place directories with frequently - used packages/styles/classes near the top of the search list.) - -2.) You have to modify (or add) the LATEX command definition in the TeX - initialization procedure. The proposed setup is to use a "LATEX" DCL - command, which gets defined in the DECUS-TEX.CLD command definition - file. - You have to edit the file TEX_ROOT:[EXE]DECUS-TEX.CLD. If there is no - entry for a verb LATEX, add one by duplicating the definition for - the verb TEX (and changing the verb name into LATEX). - a) Modify the default value of the qualifier "FORMAT" into - "TEX_FORMATS:LATEX" (if you had LaTeX-2.09, the old value - was TEX_FORMATS:LPLAIN). - b) Check, if the default value of the TEXINPUTS qualifier is - the logical name you chose for the LaTeX2e input path. Normally - this should be "TEX_INPUTS:" (WITH trailing colon!). - -Now you should rerun the command file TEX_ROOT:STARTTEX.COM to get the -changes to the TeX system setup into effect. -To trigger the redefinition of all TeX related logical names, you have -to delete the logical name TEX_ROOT by - "DEASSIGN TEX_ROOT" -(or to log out and start a new session). - - - -CHECKING THAT THE INSTALLATION WORKED -===================================== - -To check that the installation is working: - -* Be shure you have executed the STARTTEX.COM command file - (found in the root directory of the TeX directory tree). - -* Set your current directory to TEX_ROOT:[INPUTS.LATEX.SRC] - (or the location you used to unpack the LaTeX distribution). - -* Check that there is no file ARTICLE.CLS in this directory. - If you have found one, rename or remove it. - -* Execute the command - - LATEX LTXCHECK - - This will run a test on the LaTeX installation and should produce - 'OK!' to a number of test. If it does not, then see the `PROBLEMS' - section in install.txt. - - You have now installed LaTeX! - - - -POST INSTALLATION TASKS -======================= - -In the DECUS TeX distribution, there is a command procedure FMTBUILD.COM -in the TEX_FORMATS: location to simplify recreation of all TeX formats -after a change or an update to the TeX program. You might want to -integrate the new LaTeX format into this procedure. The strategy of this -procedure is to copy all needed sources into the TEX_FORMATS: location and -building the format files right there. -To include the LaTeX format in this procecure, you have to add a section -looking similar to: -======================= start here ======================== -$ -$LATEX: -$LaTeX_STD: -$!LaTeX (LaTeX2e release), standard configuration: -$ copy TEX_ROOT:[INPUTS.LATEX.SRC]*.ltx *.*; -$ copy TEX_ROOT:[INPUTS.LATEX.SRC]texsys.cfg *.cfg -$ copy TEX_ROOT:[INPUTS.LATEX.SRC]hyphen.cfg *.cfg -$ initex "latex.ltx" -$ dele *.ltx;* /log -$ dele texsys.aux;* /log -$ dele texsys.cfg;* /log -$ dele hyphen.cfg;* /log -$ -====================== end here =========================== - -When you have decided to keep the LaTeX-2.09 system, you should -modify the corresponding section in FMTBUILD.COM to reflect the -changes described in the section "SAVING ANY OLD VERSION OF LaTeX"!! - - - -RUNNING LaTeX WITH OLD VERSIONS (PD V3.4 AND EARLIER) OF DECUS TeX -================================================================== - -These version of DECUS TeX do no use the TEXINPUTS search path when -trying to open a file via \openin. This behaviour breaks the -enhance input file checking techniques implemented in LaTeX (LaTeX2e) -without further precautions. -To get around this problem, LaTeX allows an alternate way to specify the -TEXINPUTS search path to the file checking macros. This is done -through a special macro definition which has to be supplied by the -user (= LaTeX installer) via the file TEXSYS.CFG. -The following example shows a TEXSYS.CFG file which is known to work -when your LaTeX system files are accessed through the logical name -"TEX_INPUTS": - -%% texsys.cfg for DECUS TeX (VMS) -%% -% \subsection{VMS (???)} -% Some VMS implementations have different paths -% for |\openin| and |\input|. For these one could use definitions like -% the following: -% -\def\@currdir{[]} -\def\input@path{% - {SYS$DISK:[]}% - {TEX_INPUTS:}% -} -\endinput -%% -%% end of texsys.cfg for DECUS TeX - -For further details, see dircheck.dtx and texpert.txt. - - ---- Copyright 1994 Christian Spieler and the LaTeX3 project --- ---- All rights reserved. --- |