  ! LaTeX2e installation instructions  for Textures users    Blue Sky Research, July 1, 1994      SUMMARY    A This file contains specific details on how to install LaTeX2e for E Textures.  You should also read the general installation instructions B found in 'install.txt', which will explain the overall procedures.   This file describes:   2  * 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...!   C LaTeX2e installs easily with Textures, and appropriate installation H instructions follow.  Before you begin, however, here are some things to	 consider.   G Blue Sky Research will be integrating LaTeX2e into our Classic Textures B 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 G precompiled format and necessary files will be available from Blue Sky,   complete with technical support.  A Although most features of LaTeX2e can be used with any version of H Textures, some advanced capabilities of LaTeX2e require the virtual fontF facilities of Textures 1.6; others may be best handled by defining newH font maps, which is beyond the ability of many users.  We expect to haveH prepared solutions for these issues by the time we release Textures 1.7.D Although these concerns are not relevant to most users, the faint ofD heart (and those who like the backup of a live support staff) should: consider waiting for our new release to switch to LaTeX2e.  E We are not prepared to provide customer support on the use of LaTeX2e D until the release of the integrated version.  However, we hope theseH 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 theB recommended practice is to convert entirely to LaTeX2e rather thanE attempting to use both systems simultaneously.  However, for your own H security, we recommend saving your existing LaTeX format and style files2 so that you can revert to LaTeX 2.09 if necessary.  H This is easy!  Simply change the name of your existing LaTeX format fileG from 'LaTeX' to 'LaTeX 2.09' before creating the new LaTeX format file. C This format can stay in the 'TeX formats' folder, or you can set it H aside.  Also, make a *complete* copy of your current 'TeX inputs' folderH and set it aside under, say, the name 'LaTeX 2.09 inputs'.  (Some of theA files in each version of LaTeX have the same names, but different F contents, so it's not possible to put the files for both versions intoC one 'TeX inputs' folder.)  You may use any names you choose for the F set-aside folders; also, the capitalization of names is not important.  F If you need to switch back to the 2.09 version of LaTeX, you will needE first to quit Textures and then to swap 'TeX inputs' folders.  You do A this simply by renaming the folders, i.e., rename 'TeX inputs' to B 'LaTeX2e inputs', and then rename 'LaTeX 2.09 inputs' back to 'TeXE inputs'.  Each time you start Textures, the folder named 'TeX inputs' H *at that time* will be used for style files and other inputs. If you tryE 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!  E After switching the 'TeX inputs' folder, restart Textures, and choose F the 'LaTeX 2.09' format for each document you need to typeset with the older version.  C To switch back to LaTeX2e, quit Textures, and again rename the 'TeX  inputs' folder(s).      CONFIGURING TEXTURES FOR LATEX2E   E LaTeX2e uses more memory than LaTeX 2.09, so you may need to increase H the Textures memory partition; this is normally set to 2400K, and can beC increased as necessary from the Finder.  'Get Info' of the Textures = application, and enter the desired partition size, say 3000K.        " UNPACKING THE LATEX2E DISTRIBUTION  A After setting aside your older LaTeX 2.09 format and 'TeX inputs' F folder, download all of the LaTeX2e files from the CTAN archive into a folder called LaTeX2e.   E Open 'unpack.ins' in Textures.  Choose the VirTeX format and Typeset. F This will start the automated unpacking process.  Be patient, this canE take some time: anywhere from 15 minutes to 3 hours depending on your  Mac.  F NOTE: The program will likely provide prompts telling you it has foundH files by the same name on the system and asking permission to overwrite.H A `Yes' response WILL NOT overwrite existing files in other folders, but8 will create new ones in the LaTeX2e folder, so go ahead.   B Using Textures, create a new file called texsys.cfg in the LaTeX2e  folder just containing the line:   \let\@currdir=\@empty   @ This tells LaTeX that textures does not have a notion of currentA directory in the sense of some UNIX or other TeX implementations.        CREATING THE LATEX2E FORMAT      E Open 'latex.ltx' in Textures.  Again, select the VirTeX format; then, G turn off Flash Mode and select `Typeset'.  Save the resulting format as B `LaTeX'.  Move the new format from the LaTeX2e folder to your 'TeXC formats' folder and restart Textures.  The new LaTeX format will be G visible under the Typeset Menu; if the older LaTeX 2.09 format is still D in the 'TeX formats' folder, it will also be visible with that name.     - PUTTING THE FILES WHERE LATEX2E CAN READ THEM    F After running the install procedure, move the following files from the2 LaTeX2e folder into the (new) 'TeX inputs' folder:  
  latexbug.tex 
  testpage.tex   lablst.tex   idx.tex  nfssfont.tex   small2e.tex
  sample2e.tex 
  docstrip.tex   *.cls  *.clo  *.sty  *.fd   *.def  *.cfg  H The remaining files can remain in your LaTeX2e folder, which is probably$ best stored in your Textures folder.              TESTING THE LATEX2E INSTALLATION   G Open 'ltxcheck.tex' in Textures.  Select the LaTeX format, and Typeset.   H You may see the following warning in the TeX Log window, this means that@ the texsys.cfg file described above was not used. You may eitherF recreate a suitable texsys.cfg, and remake the format (you do not needA to unpack the files again) or you can simply ignore this warning.   ! article.cls in current directory! 6 ! This file should not be run in a `system directory'.  \@tempa ...a `system directory'}                                    l.145 ... `system directory'}}{}  B If the document finishes typesetting, all is well.  If there is anB installation problem, the TeX Log will produce "BAD" warnings, and refuse to continue. 7 Read the log for hints, fix the problem, and try again.      REMOVING UNNECESSARY FILES  E After LaTeX has been successfully installed, you might want to delete H some non-essential files (after making backups) to free up space on yourH hard disk.  From the LaTeX2e folder, you may delete all files ending in:  *                 .ins   .drv   .dtx    .fdd  F Note that the dtx files are documentation, for instance, documentationG on LaTeX's new class and package commands may be produced by processing G the file ltclass.dtx through LaTeX. However you do not need these files  on your hard disk to use LaTeX.      POTENTIAL PROBLEMS    FONTS:  D LaTeX2e in some cases calls for some fonts which are not part of the= Computer Modern font set, e.g., CMSY9 and others. These fonts 1 are available in our AMS PostScript font package.   F LaTeX2e will sometimes generate many, many messages about fonts in theF TeX Log.  These are diagnostic messages to aid the LaTeX2e developers,G and will not interfere with successful typesetting, Closing the TeX Log > window will speed up typesetting and allow you to ignore theseF non-essential messages. (The TeX Log window will automatically open if an error occurs.)      INSTALLATION PROBLEMS:  D If you have problems with the LaTeX installation, see the `PROBLEMS' section in install.txt.   ? --- Copyright 1994 Blue Sky Research and the LaTeX3 project --- 8 ---              All rights reserved.                ---