=              LaTeX installation instructions for Y&YTeX v1.1    +                              1994 August 20    SUMMARY  =======   G This file contains instructions for installing LaTeX2e for Y&YTeX v1.1  ; (either from DVIWindo's `TeX Menu' or from the DOS prompt).   D Before reading this file, you should obtain the LaTeX2e distributionD ---  from your nearest CTAN archive or on diskette from Y&Y, Inc. --K 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.   I NOTE:   If you get the LaTeX2e diskette from Y&Y, Inc., then installation K         is particularly easy, since ready-made `format' files are included, F         and all the files are already unpacked.  You can save time andE         effort by using the installation procedure on the diskette.   K         Please refer to the `readme.txt' file on that diskette for details.     SAVING ANY OLD VERSION OF LATEX   ===============================   J The installation instructions below for LaTeX2e are designed to *preserve*I your existing LaTeX 2.09 files.  That way you can drop back to LaTeX 2.09 G in the unlikely event that some problem should crop up.  After a while, F when you are certain that everything is working to your satisfaction, D you can delete the old files to free up some disk space (see below).  B The format file for LaTeX 2.09 is called `lplain.fmt' in the `fmt'G sub-directory of your `y&ytex' directory --- typically `c:\y&ytex\fmt'  J (or wherever the environment variable TEXFORMATS points to).  This format H file will not be disturbed by the installation of LaTeX2e since the new " format file is called `latex.fmt'.  G The style files for LaTeX 2.09 are in the `latex' sub-directory of your J `y&ytex' directory --- typically `c:\y&ytex\latex' (one of the directoriesI that the environment variable TEXINPUTS points to).  This directory will  L not be disturbed by the installation of LaTeX2e --- the new files go in the   `latex2e' sub-directory instead.  K Do the following if you want to be able to switch easily between LaTeX 2.09 E and LaTeX2e.  Set the TEXINPUTS environment variable so the directory G 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   F Then you can call LaTeX2.09 with the old `latex.bat' batch file (whichA uses `&lplain' on the TeX command line), and you can call LaTeX2e G using  the new `latex2e.bat' batch file (which uses `&latex' on the TeX F command line).  DVIWindo's `TeX Menu' will list *both* the old `LaTeX'2 (i.e. LaTeX 2.09) and the new `LaTeX 2e' formats.   B Once you decide that you no longer need LaTeX 2.09, you can save a% bit of disk space.  Do the following:   O (i)   delete `lplain.*' from the `fmt' sub-directory of the `y&ytex' directory; O (ii)  delete  all files in the `latex' sub-directory of the `y&ytex' directory; 8 (iii) remove the `LaTeX' entry in DVIWindo's `TeX Menu';G (iv)  delete the `latex.bat' batch file from your batch file directory.    CONFIGURING LATEX  =================   L NOTE: You can pretty much ignore the rest of this file if you use the ready-E       made format files on the diskette from Y&Y!  Otherwise read on.   M First of all, to run the installation procedure you need to set the TEXINPUTS O environment variable to include the directory with the LaTeX 2e source files--- K or make it the current directory.  If you use the recommended directory you  can just set:   #         TEXINPUTS=c:\y&ytex\latex2e   F After running the installation procedure you need to add the `latex2e'C subdirectory of the `y&ytex' directory to the directory list in the H TEXINPUTS environment variable.  If you want to be able to switch easilyH 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  I If you will *only* be using the new LaTeX2e, you can, of course, omit the ( reference to the `latex' subdirectory.    B NOTE: If you have a recent version of the Y&Y TeX system, then theG       environment variables are defined in the [Environment] section of E       `dviwindo.ini'. With an older system you insert code to set the G       environment variables in  your `autoexec.bat' file --- this takes #       effect when you next reboot.    J You can run LaTeX2e from DVIWindo's `TeX Menu' --- by selecting `LaTeX 2e'I --- or direct from DOS.  In the latter case you can just use the existing  `tex.bat' batch file:             tex &latex <source-file>  G Or you may find it convenient to create a new `latex2e.bat' batch file. G To do this, just copy `latex.bat', and replace `&lplain' with `&latex'.   H While LaTeX2e requires more TeX memory than LaTeX 2.09, there is no needF to do anything, since Y&YTeX's dynamic memory allocation automatically& only uses as much memory as is needed.   UNPACKING THE DISTRIBUTION   ==========================    K NOTE: If you get the LaTeX 2e diskette from Y&Y, you won't need to `unpack' M       the files. But if you do not have the unpacked distribution, read on.   L       You have the `unpacked' distribution if you have the file `latex.ltx'.  B Create a directory on your hard disk for the LaTeX2e source files F (Don't mix them up with other files, since you may want to delete someH again after installation in order to conserve disk space).  For example:           mkdir c:\y&ytex\latex2e   H Get the latest version of the distribution off your nearest CTAN site byA anonymous FTP (Or run the installation batch file on the LaTeX2e  > distribution diskette to unzip the files into this directory).  K Create an empty temporary directory (on a drive with at least a Megabyte of I free space).  Make that the current directory.  Next, set the environment G variable TEXINPUTS to include the directory with the new LaTeX2e source  files.  For example:  #         TEXINPUTS=c:\y&ytex\latex2e   G You will also need to supply a file with hyphenation patterns.  You can H do this either by copying the standard `hyphen.tex' file for English ---E or a hyphenation pattern file for another language --- to the current I directory, or by adding a directory (s.a. c:\y&ytex\latex) which contains N `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  L You can create new TeX formats (i) directly from the `TeX Menu' in DVIWindo,H (ii) using the `initex.bat' batch file, or (iii) `manually' from the DOSL command line.  If you work from the `TeX Menu' or use the `initex.bat' batchK file, then most of the details of LaTeX2e format creation are automatically H taken care off.  In fact, the two steps "Unpacking the Distribution" andK "Creating the LaTeX format" are then combined into *one* operation, and you # need not deal with all the details.   K For example, if you run ini-TeX from the `TeX menu' in DVIWindo, just enter J `LaTeX 2e' for `Format Name' and enter `latex' for `Format Source File' ifH you are installing the final release of LaTeX2e.  The `initex.bat' batchJ file which is called will take care of running ini-TeX *twice* --- once onM `unpack.ins', then on `latex.ltx' (or `unpack2e.ins' and `latex2e.ltx' in the K beta release version).  It will also copy the finished `format' file to the M `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!     G If you instead want to unpack the files `manually' from the DOS prompt, F 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    N This may take some time --- on an old 486 it may take as long as 4--5 minutes.L You can speed the process up somewhat by choosing a temporary directory on aE 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  =========================   L NOTE: If you called ini-TeX form the `TeX Menu' in DVIWindo, then the formatI       has already been created and saved, so nothing else need be done!   <       Read on if you instead unpacked the files `manually'.   I Running ini-TeX on the file `unpack.ins' creates a large number of files, @ including `latex.ltx' (You also need to supply `hyphen.tex' withJ hyphenation patterns --- see previous section).  To create the new LaTeX2eC format, now run ini-TeX on `latex.ltx'.  You can use the batch file  `tex.bat' again:           tex -i latex.ltx  9 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 , ===========================================   H 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'7 sub-directory of your `y&ytex' directory.  For example:            mkdir c:\y&ytex\latex2e   C Then copy all of the files from the temporary directory to that new  directory.  For example:  "         copy *.* c:\y&ytex\latex2e  M 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 & =====================================   F To check that the installation worked, run the new LaTeX2e on the fileH `ltxcheck.tex'.  You can do this from DVIWindo's `TeX Menu' or from the 
 DOS prompt.     H In the `TeX Menu' simply select `LaTeX 2e' and in the `Open File' dialogI 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!C The test file will check some basic features of your TeX setup and  8 either say they are OK or complain and say they are BAD.  E After this, you may also wish to process `usrguide.tex' and print the E result, unless you have already done so (and perhaps `fntguide.tex').   	 PROBLEMS  	 ========    D If you have an older Y&Y TeX Package, then it will be set up for theJ beta release file names.  In particular, the older batch file `initex.bat'I refers to `unpack2e.ins' and `latex2e.ltx' in the two calls to ini-TeX.   I If you have the final release of LaTeX2e, then change these references to J `unpack.ins' and `latex.ltx'. And if your files are really old (1993 Dec) N 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'.    E If `ltxcheck' produces a `BAD' message, you will typically be able to D figure out from the message what is wrong.  For example, you may notA have the environment variable TEXINPUTS set up to include the new C LaTeX2e files.  If it is not obvious what caused the `BAD' message, @ then please consult the section on `ltxcheck' in `texpert.txt'.   D WARNING:   When using fonts other than Computer Modern look out for B            font naming problems.  For example, with LucidaBright +I            LucidaNewMath, use the style option [kb] for Karl Berry names  B            or [yy] for the actual font names with `lucidbr' style.  D WARNING:   When using fonts other than Computer Modern look out for B            font encoding problems.  LaTeX2e directly supports onlyH            the old `TeX text' encoding (OT1 -- textext.vec), and the newJ            `Cork' encoding (T1 -- tex256.vec).  Use `\input ansiacce' (forL            Windows ANSI) or  `\input stanacce' (for Adobe StandardEncoding).  J 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 --- 9 ---              All rights reserved.                ---        