LaTeX installation instructions for Y&YTeX v1.1 1994 May 23 SUMMARY ======= This file contains instructions for installing LaTeX2e for Y&YTeX v1.1 (either from DVIWindo's `TeX Menu' or from the DOS prompt). Before reading this file, you should read `install.txt', which explains how the LaTeX2e installation works. This file describes: * How to save any old version of LaTeX. * How to configure LaTeX. * How to unpack the LaTeX distribution. * How to create the LaTeX format. * How to install the LaTeX files. * How to check the LaTeX installation. * What to do if you have any problems. SAVING ANY OLD VERSION OF LATEX =============================== The installation instructions below for LaTeX2e are designed to *preserve* your existing LaTeX 2.09 files. That way you can drop back to LaTeX 2.09 in the unlikely event that some problem should crop up. After a while, when you are certain that everything is working to your satisfaction, you can delete the old files to free up some disk space (see below). The format file for LaTeX 2.09 is called `lplain.fmt' in the `fmt' sub-directory of your `y&ytex' directory --- typically `c:\y&ytex\fmt' (or wherever the environment variable TEXFORMATS points to). This format file will not be disturbed by the installation of LaTeX2e since the new format file is called `latex.fmt'. The style files for LaTeX 2.09 are in the `latex' sub-directory of your `y&ytex' directory --- typically `c:\y&ytex\latex' (one of the directories that the environment variable TEXINPUTS points to). This directory will not be disturbed by the installation of LaTeX2e --- the new files go in the `latex2e' sub-directory instead. Do the following if you want to be able to switch easily between LaTeX 2.09 and LaTeX2e. Set the TEXINPUTS environment variable so the directory with the LaTeX 2.09 files is listed *before* the directory with the new LaTeX2e files. For example: set TEXINPUTS=c:\tex;c:\letters;c:\y&ytex\latex;c:\y&ytex\latex2e Then you can call LaTeX2.09 with the old `latex.bat' batch file (which uses `&lplain' on the Y&YTeX command line), and you can call LaTeX2e using the new `latex2e.bat' batch file (which uses `&latex' on the Y&YTeX command line). DVIWindo's `TeX Menu' will list *both* the old `LaTeX' (i.e. LaTeX 2.09) and the new `LaTeX2e' formats. Once you decide that you no longer need LaTeX 2.09, you can save a bit of disk space. Do the following: (i) delete `lplain.*' from the `fmt' sub-directory of the `y&ytex' directory; (ii) delete all files in the `latex' sub-directory of the `y&ytex' directory; (iii) remove the `LaTeX' entry in DVIWindo's `TeX Menu'; (iv) delete the `latex.bat' batch file from your batch file directory. CONFIGURING LATEX ================= First of all, to run the installation procedure you need to set the TEXINPUTS environment variable to include the directory with the LaTeX2e source files. If you use the recommended directory you could just type: set TEXINPUTS=c:\latex2e After running the installation procedure you need to add the `latex2e' subdirectory of the `y&ytex' directory to the directory list in the TEXINPUTS environment variable. If you want to be able to switch easily between the old LaTeX 2.09 and LaTeX2e, then add the `latex2e' directory *after* the `latex' directory. For example: set TEXINPUTS=c:\tex;c:\letters;c:\y&ytex\latex;c:\y&ytex\latex2e If you will *only* be using the new LaTeX2e, you can, of course, omit the reference to the `latex' subdirectory. Typically you insert code to set the environment variables in your `autoexec.bat' file so that it always takes effect when you reboot. To avoid having to reboot before using LaTeX2e, *also* execute the above environment setting code from the command line in DOS (but *not* in a DOS box in Windows). You can run LaTeX2e from DVIWindo's `TeX Menu' --- by selecting `LaTeX 2e' --- or direct from DOS. In the latter case you can just use the existing `tex.bat' batch file: tex &latex Or you may find it convenient to create a new `latex2e.bat' batch file. To do this, simply copy `latex.bat', and replace `&lplain' with `&latex'. While LaTeX2e requires more TeX memory than LaTeX 2.09, there is no need to do anything, since Y&YTeX's dynamic memory allocation automatically only uses as much memory as is needed. UNPACKING THE DISTRIBUTION ========================== Create a directory on your hard disk for the LaTeX2e source files (Don't mix them up with other files, since you may want to delete them again after installation in order to conserve disk space). For example: mkdir c:\latex2e Run the installation batch file on the LaTeX2e distribution diskette to unzip the files into this directory --- or get the latest version of the distribution off your nearest CTAN site by anonymous FTP. Create an empty temporary directory (on a drive with at least a Megabyte of free space). Make that the current directory. Next, set the environment variable TEXINPUTS to include the directory with the new LaTeX2e source files. For example: set TEXINPUTS=c:\latex2e You will also need to supply a file with hyphenation patterns. You can do this either by copying the standard `hyphen.tex' file for English --- or a hyphenation pattern file for another language --- to the current directory, or by adding a directory (s.a. c:\y&ytex\latex) which contains `hyphen.tex' to the list of directories in the TEXINPUTS environment variable: set TEXINPUTS=c:\latex2e;c:\y&ytex\latex Also make sure the environment variable TEXFORMATS points to the `fmt' sub-directory of your `y&ytex' directory. For example: set TEXFORMATS=c:\y&ytex\fmt You can create new TeX formats (i) directly from the `TeX Menu' in DVIWindo, (ii) using the `initex.bat' batch file, or (iii) `manually' from the DOS command line. If you work from the `TeX Menu' or use the `initex.bat' batch file, then most of the details of LaTeX2e format creation are automatically taken care off. In fact, the two steps "Unpacking the Distribution" and "Creating the LaTeX format" are then combined into *one* operation, and you need not deal with all the details. For example, if you run ini-TeX from the `TeX menu' in DVIWindo, just enter `LaTeX 2e' for `Format Name' and enter `latex2e' for `Format Source File.' The `initex.bat' batch file which is called will take care of running ini-TeX *twice* (once on `unpack.ins', then on `latex.ltx'). It will also copy the finished `format' file to the `fmt' sub-directory of your `y&ytex' directory, and create a `LaTeX 2e' entry in the `TeX Menu' * And that is all there is to it! (Unless the names of the LaTeX2e files have changed again --- see `Problem' section at end) If you instead want to unpack the files `manually' from the DOS prompt, run ini-TeX on the file `unpack.ins'. Using the `tex.bat' batch file: tex -i unpack.ins (or call Y&YTeX directly: c:\y&ytex\y&ytex -i unpack.ins). This may take some time --- on an old 486 it may take as long as 4--5 minutes. You can speed the process up somewhat by choosing a temporary directory on a RAM drive rather than a hard disk (and avoid reading the source files directly from a diskette instead of copying them to a hard disk first). CREATING THE LATEX FORMAT ========================= If you called ini TeX form the `TeX Menu' in DVIWindo, then the format has already been created and saved, so nothing else need be done! Read on if you instead unpacked the files `manually'. Running ini-TeX on the file `unpack.ins' creates a large number of files, including `latex.ltx'. You also need to supply `hyphen.tex' with hyphenation patterns (see previous section). To create the new LaTeX2e format, now run ini-TeX on `latex.ltx'. You can use the batch file `tex.bat' again: tex -i latex.ltx (or call Y&YTeX directly: c:\y&ytex\y&ytex -i latex.ltx). The resulting format file, `latex.fmt' should be copied to the `fmt' sub-directory of your `y&ytex' directory. For example, copy latex.fmt c:\y&ytex\fmt You may also wish to copy `latex.log' to the `fmt' directory. PUTTING THE FILES WHERE LATEX CAN READ THEM =========================================== You also need to move the files created when ini-TeX ran on `undump.ins' to a permanent home where TeX can find them. Create a `latex2e' sub-directory of your `y&ytex' directory. For example: mkdir c:\y&ytex\latex2e Then copy all of the files from the temporary directory to that new directory. For example: copy *.* c:\y&ytex\latex2e Then add this directory to the list of directories in TEXINPUTS. For example: set TEXINPUTS=c:\tex;c:\letters;c:\y&ytex\latex;c:\y&ytex\latex2e You have now installed LaTeX 2e! CHECKING THAT THE INSTALLATION WORKED ===================================== It is important to check that the installation worked. To do this run the new LaTeX2e on the file `ltxcheck.tex'. You can do this from DVIWindo's `TeX Menu' or from the DOS command line. In the `TeX Menu' simply select `LaTeX 2e' and in the `Open File' dialog navigate to `c:\y&ytex\latex2e\ltxcheck.tex' (or wherever you placed your LaTeX2e source files). Or, run Y&YTeX directly using `tex.bat': tex &latex ltxcheck It is highly recommended that you run this test before going on! The test file will check some basic features of your TeX setup and either say they are OK or complain and say they are BAD. After this, you may also wish to process `features.tex' and print the result, unless you have already done so. PROBLEMS ======== The names of the basic files of LaTeX2e have changed since it first appeared in alpha release. As a result you may have a Y&Y TeX Package that is set up for some older set of file names. Check in particular that the batch file `initex.bat' refers to `unpack.ins' and `latex.ltx' in the two calls to ini-TeX. You may very well have to replace the old file names `unpack2e.ins' and `latex2e.ltx' with the new `unpack.ins' and `latex.ltx'. If you have other problems with the LaTeX installation, see the `PROBLEMS' section in `install.txt'. If `ltxcheck' produces a `BAD' message, you will typically be able to figure out from the message what is wrong. For example, you may not have the environment variable TEXINPUTS set up to include the new LaTeX2e files. If it is not obvious what caused the `BAD' message, then please consult the section on `ltxcheck' in `texpert.txt'. If you have any problems not resolved by the above, please contact Y&Y at: 71172.524@compuserve.com (email) (508) 371-2004 (fax) (508) 371-3286 (voice) Y&Y, Inc. 45 Walden Street (snail mail) Concord, MA, 01742, USA --- Copyright 1994 (C) Y&Y, Inc. and the LaTeX3 project --- --- All rights reserved. ---