LaTeX2e installation instructions for Textures users To be used in conjunction with LaTeX2e distribution files downloaded from a CTAN archive, such as ftp.shsu.edu in the /tex-archive/macros/latex2e/base directory. Log in as anonymous using your e-mail address as your password. Blue Sky Research, July 1, 1994 SUMMARY This file contains specific details on how to install LaTeX2e for Textures. You should also read the general installation instructions found in 'install.txt', which will explain the overall procedures. This file describes: * How to save the previous version of LaTeX 2.09; * How to unpack the LaTeX2e distribution; * How to create the LaTeX2e format; * How to install the LaTeX2e files. FOR THOSE WHO ARE NERVOUS...! LaTeX2e installs easily with Textures, and appropriate installation instructions follow. Before you begin, however, here are some things to consider. Blue Sky Research will be integrating LaTeX2e into our Classic Textures package, version 1.7, to be released in early fall. At that time, LaTeX2e will become a regular part of our product line, and the precompiled format and necessary files will be available from Blue Sky, complete with technical support. Although most features of LaTeX2e can be used with any version of Textures, some advanced capabilities of LaTeX2e require the virtual font facilities of Textures 1.6; others may be best handled by defining new font maps, which is beyond the ability of many users. We expect to have prepared solutions for these issues by the time we release Textures 1.7. Although these concerns are not relevant to most users, the faint of heart (and those who like the backup of a live support staff) should consider waiting for our new release to switch to LaTeX2e. We are not prepared to provide customer support on the use of LaTeX2e until the release of the integrated version. However, we hope these instructions will provide the basics for successful operation of LaTeX2e until then. SAVING YOUR 2.09 VERSION OF LATEX LaTeX2e can process LaTeX 2.09 documents in most cases, so the recommended practice is to convert entirely to LaTeX2e rather than attempting to use both systems simultaneously. However, for your own security, we recommend saving your existing LaTeX format and style files so that you can revert to LaTeX 2.09 if necessary. This is easy! Simply change the name of your existing LaTeX format file from 'LaTeX' to 'LaTeX 2.09' before creating the new LaTeX format file. This format can stay in the 'TeX formats' folder, or you can set it aside. Also, make a *complete* copy of your current 'TeX inputs' folder and set it aside under, say, the name 'LaTeX 2.09 inputs'. (Some of the files in each version of LaTeX have the same names, but different contents, so it's not possible to put the files for both versions into one 'TeX inputs' folder.) You may use any names you choose for the set-aside folders; also, the capitalization of names is not important. If you need to switch back to the 2.09 version of LaTeX, you will need first to quit Textures and then to swap 'TeX inputs' folders. You do this simply by renaming the folders, i.e., rename 'TeX inputs' to 'LaTeX2e inputs', and then rename 'LaTeX 2.09 inputs' back to 'TeX inputs'. Each time you start Textures, the folder named 'TeX inputs' *at that time* will be used for style files and other inputs. If you try to run either version of LaTeX with the wrong 'TeX inputs' folder, no harm will be done, but you will be swimming in error messages! After switching the 'TeX inputs' folder, restart Textures, and choose the 'LaTeX 2.09' format for each document you need to typeset with the older version. To switch back to LaTeX2e, quit Textures, and again rename the 'TeX inputs' folder(s). CONFIGURING TEXTURES FOR LATEX2E LaTeX2e uses more memory than LaTeX 2.09, so you may need to increase the Textures memory partition; this is normally set to 2400K, and can be increased as necessary from the Finder. 'Get Info' of the Textures application, and enter the desired partition size, say 3000K. UNPACKING THE LATEX2E DISTRIBUTION After setting aside your older LaTeX 2.09 format and 'TeX inputs' folder, ownload all of the LaTeX2e files from the CTAN archive into a folder called LaTeX2e. Open 'unpack.ins' in Textures. Choose the VirTeX format and Typeset. This will start the automated unpacking process. Be patient, this can take some time: anywhere from 15 minutes to 3 hours depending on your Mac. NOTE: The program will likely provide prompts telling you it has found files by the same name on the system and asking permission to overwrite. A `Yes' response WILL NOT overwrite existing files in other folders, but will create new ones in the LaTeX2e folder, so go ahead. CREATING THE LATEX2E FORMAT Open 'latex.ltx' in Textures. Again, select the VirTeX format; then, turn off Flash Mode and select `Typeset'. Save the resulting format as `LaTeX'. Move the new format from the LaTeX2e folder to your 'TeX formats' folder and restart Textures. The new LaTeX format will be visible under the Typeset Menu; if the older LaTeX 2.09 format is still in the 'TeX formats' folder, it will also be visible with that name. PUTTING THE FILES WHERE LATEX2E CAN READ THEM After running the install procedure, move the following files from the LaTeX2e folder into the (new) 'TeX inputs' folder: latexbug.tex testpage.tex docstrip.tex. *.cls *.clo *.sty *.fd *.def *.cfg The remaining files can remain in your LaTeX2e folder, which is probably best stored in your Textures folder. TESTING THE LATEX2E INSTALLATION Open 'ltxcheck.tex' in Textures. Select the LaTeX format, and Typeset. You should see the following warning in the TeX Log window: article.cls in current directory! ! This file should not be run in a `system directory'. \@tempa ...a `system directory'} l.145 ... `system directory'}}{} This warning is normal; just hit `Continue'. This is not an installation error, but shows that Textures automatically searches the 'TeX inputs' folder whenever it cannot find a file that was requested. If the document finishes typesetting, all is well. If there is an installation problem, the TeX Log will produce "BAD" warnings, and refuse to continue. Read the log for hints, fix the problem, and try again. REMOVING UNNECESSARY FILES After LaTeX has been successfully installed, you might want to delete some non-essential files (after making backups) to free up space on your hard disk. From the LaTeX2e folder, you may delete all files ending in: .ins .drv .dtx .fdd POTENTIAL PROBLEMS FONTS: LaTeX2e in some cases calls for some fonts which are not part of the Computer Modern font set, e.g., CMSY9 and others. Most of these fonts are available in our AMS PostScript font package. LaTeX2e will sometimes generate many, many messages about fonts in the TeX Log. These are diagnostic messages to aid the LaTeX2e developers, and will not interfere with successful typesetting, Closing the TeX Log window will speed up typesetting and allow you to ignore these non-essential messages. (The TeX Log window will automatically open if an error occurs.) INSTALLATION PROBLEMS: If you have problems with the LaTeX installation, see the `PROBLEMS' section in install.txt. --- Copyright 1994 Blue Sky Research and the LaTeX3 project --- --- All rights reserved. ---