=      LaTeX installation instructions for DECUS TeX (OpenVMS)    *                            15 August 1994      SUMMARY  =======   < This file contains instructions on how to install LaTeX for A DECUS TeX on OpenVMS.  Before reading this file, you should read  B 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.   F  * Running LaTeX with old versions (PD V3.4 and earlier) of DECUS TeX       SAVING ANY OLD VERSION OF LaTeX   ===============================   E If you are currently using the old LaTeX version, 2.09, you may wish  7 to save it before installing the new version of LaTeX.    I a) The old LaTeX 2.09 version will be kept in a subdirectory [.LATEX209]  8    in your TeXinputs tree (normally TEX_ROOT:[INPUTS]).   H    When your LaTeX distribution was already installed in a subdirectory -    (e.g. [.LATEX]), simply execute a rename:  5      RENAME TEX_ROOT:[INPUTS]LATEX.DIR  LATEX209.DIR  G    (You may have to modify the file protection of the directory file.0    C    Otherwise, create a new subdirectory TEX_ROOT:[INPUTS.LATEX209]  H    All style files (.STY) as well as LATEX.TEX, LPLAIN.TEX, LFONTS.TEX, I    SLITEX.TEX, SPLAIN.TEX, SFONTS.TEX, LHYPHEN.TEX, IDX.TEX, LABLST.TEX,  H    MAKEINDEX.TEX, SAMPLE.TEX, SMALL.TEX, TRYFONTS.TEX, TESTPAGE.TEX and 3    TESTA4.TEX should be moved into this directory.    H 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:  I    Edit the command procedure that is used to initialize the TeX system:  I    This is probably the file STARTTEX.COM, located in TEX_ROOT:[000000].  J    Search for the definition of the TEX_INPUTS search list. Add a similar G    definition using another name (.e.g. LTX_INPUTS) by duplicating the  E    search list in STARTTEX.COM. Change this new definition by adding  D    an entry "TEX_ROOT:[INPUTS.LATEX209]" at the top of the list, so L    that the files from the old LaTeX-2.09 are accessed before the new files     from LaTeX2e.    F c) To use the old LaTeX 2.09 format, you have to define a new command H    which uses the new logical name LTX_INPUTS as TeXinputs search path. G    This is archived by adding the following line to STARTTEX.COM (best  5    place: just after the INITEX command definition):    H    "$   OLATEX :== TEX/FORMAT=TEX_FORMATS:LPLAIN/TEXINPUTS=LTX_INPUTS:"   L d) There is no need to rename the old format file LPLAIN.FMT. The new LaTeX 9    format uses a different name (LATEX.FMT) per default.  I    But if there is a command procedure to generate the format files, you  M    might want to update it to reflect the changed location of the LaTeX-2.09      sources.   L To install the recent changes, you have to reexecute the TeX initialization I 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   ==========================    A 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].  A Copy the hole LaTeX distribution into this directory, and change  D your working directory to this location with a SET DEFAULT command.  Now simply type   "INITEX UNPACK.INS"  B (after you have initialized the TeX system). The unpack procedure $ should then proceed without errors. B The time needed for Unpacking depends on your hardware equipment. L On an Alpha AXP machine (DEC 3000/400), this will last less than 5 minutes; I 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:  ----------------------- I If you have a recent version of DECUS TeX (3.1415, PD V3.5 or later), no  J special texsys.cfg file is needed. DECUS TeX is now fully compatible with H the extended input checking techniques used in the new LaTeX (LaTeX2e). K For a usable texsys.cfg setup with older (outdated) versions of DECUS TeX,   see the section D "Running LaTeX with old versions (PD 3.4 and earlier) of DECUS TeX"  below.    1 B) Setting up multilingual hyphenation patterns:  1 ------------------------------------------------  C 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.  D Your HYPHEN.CFG file should load all required hyphenation patterns. J At the end, the default language should be switched on and the appropiate I values of \lefthyphenmin and \righthyphenmin for this language should be   set.  F It is strongly recommended to load the USenglish hyphenation patterns L as language 0 and to use this language as default to maintain compatibility K with other installations. This setup is needed to allow correct processing  6 of the delivered (english) LaTeX documentation files! B As an example for a HYPHEN.CFG file, a bilingual setup for german K and US english (can be used together with the babel package or german.sty)  
 is shown:  %%   %% This is file `hyphen.cfg',  %%  K %% Modified for dual language support by Christian Spieler, 20. June 1994.   %%  , %% This file is part of the LaTeX2e system. , %% ----------------------------------------  %%    B \message{Loading hyphenation patterns for US english and German.}   ( % PREPARING A FOREIGN LANGUAGE VERSION:  % 7 % This file loads hyphenation patterns for US english.  @ % If you want to load additional or other hyphenation patterns, D % you have to change this file, which is hereby allowed explicitly, D % 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.  F 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 2 store its macros than previous versions of LaTeX. I Since DECUS TeX is compiled as (64 bit) BigTeX with large memory arrays,  % this should not impose any problems.  I When you have got a newer version of DECUS TeX (3.1415 PD 3.3a or later)  L there should be enough pattern memory to load at least hyphenation patterns I 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: E Up to now, DECUS TeX does not allow to adjust its internal arrays at  B run time. Therefore, if you really need more space somewhere, you E have to recompile TeX -- the program -- with the appropiate changes,   sorry.         CREATING THE LaTeX FORMAT  =========================   E Be sure that all hyphenation pattern sources requested by HYPHEN.CFG  D are accessible through the TEX_INPUTS search list. When you did not F create a HYPHEN.CFG file, at least the US english hyphenation pattern 2 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.    D 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: 3   SET FILE/PROTECTION=(W:RE) TEX_FORMATS:LATEX.FMT    F (If TEX_FORMATS: is located on a different disk in your installation, J 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 , ===========================================   E The LaTeX class and style files as well as some auxiliary .TEX files  D need to be put in a directory of the TEX_INPUTS search path. In the E suggested setup, this is simply the parent directory of the location  * where you have unpacked the distribution.  You should apply:   5   RENAME latexbug.tex, testpage.tex, docstrip.tex, -  F       lablst.tex, idx.tex, nfssfont.tex, small2e.tex, sample2e.tex, - 3       *.cls, *.clo, *.sty, *.fd, *.def, *.ist  [-]         FINAL INSTALLATION STEPS   ========================    1 To use LaTeX, some preparations need to be done:    G 1.) You have to enshure that TeX looks into the right directories when  D     searching for LaTeX styles and classes. In the suggested setup, G     the LaTeX core classes and styles have been put into the directory  D     TEX_ROOT:[INPUTS.LATEX]. This directory needs to be part of the F     Texinputs search list, which is (normally) defined by the logical I     name TEX_INPUTS (without colon!). Check the TeX startup command file  E     STARTTEX.COM (should be found in TEX_ROOT:[000000]). The list of  F     equivalences in the definition of "TEX_INPUTS" should contain the I     directory where you intend to place the LaTeX2e classes. For correct  I     operation, it is ABSOLUTELY neccessary that this directory is listed  1     before any location of old LaTeX-2.09 files!  K     (For efficiency, it might be best to place directories with frequently  C     used packages/styles/classes near the top of the search list.)    H 2.) You have to modify (or add) the LATEX command definition in the TeX I     initialization procedure. The proposed setup is to use a "LATEX" DCL  H     command, which gets defined in the DECUS-TEX.CLD command definition 
     file. J     You have to edit the file TEX_ROOT:[EXE]DECUS-TEX.CLD. If there is no F     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  A        "TEX_FORMATS:LATEX" (if you had LaTeX-2.09, the old value           was TEX_FORMATS:LPLAIN). A     b) Check, if the default value of the TEXINPUTS qualifier is  G        the logical name you chose for the LaTeX2e input path. Normally  <        this should be "TEX_INPUTS:" (WITH trailing colon!).   G Now you should rerun the command file TEX_ROOT:STARTTEX.COM to get the  - changes to the TeX system setup into effect.  G 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    D   This will run a test on the LaTeX installation and should produce F   '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  =======================   I In the DECUS TeX distribution, there is a command procedure FMTBUILD.COM  G in the TEX_FORMATS: location to simplify recreation of all TeX formats  B after a change or an update to the TeX program. You might want to I integrate the new LaTeX format into this procedure. The strategy of this  K procedure is to copy all needed sources into the TEX_FORMATS: location and  ' building the format files right there.  I To include the LaTeX format in this procecure, you have to add a section   looking similar to: < ======================= start here ========================  $  $LATEX:  $LaTeX_STD: 3 $!LaTeX (LaTeX2e release), standard configuration:  - $ copy TEX_ROOT:[INPUTS.LATEX.SRC]*.ltx *.*;  3 $ copy TEX_ROOT:[INPUTS.LATEX.SRC]texsys.cfg *.cfg  3 $ 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 E changes described in the section "SAVING ANY OLD VERSION OF LaTeX"!!        C RUNNING LaTeX WITH OLD VERSIONS (PD V3.4 AND EARLIER) OF DECUS TeX  C ==================================================================    D These version of DECUS TeX do no use the TEXINPUTS search path when = trying to open a file via \openin. This behaviour breaks the  F enhance input file checking techniques implemented in LaTeX (LaTeX2e)  without further precautions.  I To get around this problem, LaTeX allows an alternate way to specify the  @ TEXINPUTS search path to the file checking macros. This is done C through a special macro definition which has to be supplied by the  2 user (= LaTeX installer) via the file TEXSYS.CFG. E The following example shows a TEXSYS.CFG file which is known to work  C when your LaTeX system files are accessed through the logical name   "TEX_INPUTS":   " %% texsys.cfg for DECUS TeX (VMS)  %%   % \subsection{VMS (???)}  0 % Some VMS implementations have different paths G % 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    7 For further details, see dircheck.dtx and texpert.txt.      @ --- Copyright 1994 Christian Spieler and the LaTeX3 project --- 9 ---              All rights reserved.                ---  