LaTeX installation instructions for Y&YTeX v1.1 1994 August 20 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 obtain the LaTeX2e distribution --- from your nearest CTAN archive or on diskette from Y&Y, Inc. -- and 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. NOTE: If you get the LaTeX2e diskette from Y&Y, Inc., then installation is particularly easy, since ready-made `format' files are included, and all the files are already unpacked. You can save time and effort by using the installation procedure on the diskette. Please refer to the `readme.txt' file on that diskette for details. 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: TEXINPUTS=c:\texinput;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 TeX command line), and you can call LaTeX2e using the new `latex2e.bat' batch file (which uses `&latex' on the TeX command line). DVIWindo's `TeX Menu' will list *both* the old `LaTeX' (i.e. LaTeX 2.09) and the new `LaTeX 2e' 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 ================= NOTE: You can pretty much ignore the rest of this file if you use the ready- made format files on the diskette from Y&Y! Otherwise read on. First of all, to run the installation procedure you need to set the TEXINPUTS environment variable to include the directory with the LaTeX 2e source files--- or make it the current directory. If you use the recommended directory you can just set: TEXINPUTS=c:\y&ytex\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: TEXINPUTS=c:\texinputs;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. NOTE: If you have a recent version of the Y&Y TeX system, then the environment variables are defined in the [Environment] section of `dviwindo.ini'. With an older system you insert code to set the environment variables in your `autoexec.bat' file --- this takes effect when you next reboot. 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, just 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 ========================== NOTE: If you get the LaTeX 2e diskette from Y&Y, you won't need to `unpack' the files. But if you do not have the unpacked distribution, read on. You have the `unpacked' distribution if you have the file `latex.ltx'. 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 some again after installation in order to conserve disk space). For example: mkdir c:\y&ytex\latex2e Get the latest version of the distribution off your nearest CTAN site by anonymous FTP (Or run the installation batch file on the LaTeX2e distribution diskette to unzip the files into this directory). 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: TEXINPUTS=c:\y&ytex\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. Also make sure the environment variable TEXFORMATS points to the `fmt' sub-directory of your `y&ytex' directory. For example: 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 `latex' for `Format Source File' if you are installing the final release of LaTeX2e. The `initex.bat' batch file which is called will take care of running ini-TeX *twice* --- once on `unpack.ins', then on `latex.ltx' (or `unpack2e.ins' and `latex2e.ltx' in the beta release version). 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! 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 by copying them to a hard disk first). CREATING THE LATEX FORMAT ========================= NOTE: 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: TEXINPUTS=c:\texinput;c:\y&ytex\latex;c:\y&ytex\latex2e You have now installed LaTeX 2e! CHECKING THAT THE INSTALLATION WORKED ===================================== To check that the installation worked, run the new LaTeX2e on the file `ltxcheck.tex'. You can do this from DVIWindo's `TeX Menu' or from the DOS prompt. 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 `usrguide.tex' and print the result, unless you have already done so (and perhaps `fntguide.tex'). PROBLEMS ======== If you have an older Y&Y TeX Package, then it will be set up for the beta release file names. In particular, the older batch file `initex.bat' refers to `unpack2e.ins' and `latex2e.ltx' in the two calls to ini-TeX. If you have the final release of LaTeX2e, then change these references to `unpack.ins' and `latex.ltx'. And if your files are really old (1993 Dec) and still refers to `latex2e.ins' then please change that to `unpack.ins'... 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'. WARNING: When using fonts other than Computer Modern look out for font naming problems. For example, with LucidaBright + LucidaNewMath, use the style option [kb] for Karl Berry names or [yy] for the actual font names with `lucidbr' style. WARNING: When using fonts other than Computer Modern look out for font encoding problems. LaTeX2e directly supports only the old `TeX text' encoding (OT1 -- textext.vec), and the new `Cork' encoding (T1 -- tex256.vec). Use `\input ansiacce' (for Windows ANSI) or `\input stanacce' (for Adobe StandardEncoding). 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. ---