diff options
Diffstat (limited to 'systems/mac/textures/formats/Textures_forLaTeX2e.txt')
-rw-r--r-- | systems/mac/textures/formats/Textures_forLaTeX2e.txt | 193 |
1 files changed, 193 insertions, 0 deletions
diff --git a/systems/mac/textures/formats/Textures_forLaTeX2e.txt b/systems/mac/textures/formats/Textures_forLaTeX2e.txt new file mode 100644 index 0000000000..70ba4151f2 --- /dev/null +++ b/systems/mac/textures/formats/Textures_forLaTeX2e.txt @@ -0,0 +1,193 @@ + +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. ---
\ No newline at end of file |