summaryrefslogtreecommitdiff
path: root/systems/mac/textures/formats/Textures_forLaTeX2e.txt
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /systems/mac/textures/formats/Textures_forLaTeX2e.txt
Initial commit
Diffstat (limited to 'systems/mac/textures/formats/Textures_forLaTeX2e.txt')
-rw-r--r--systems/mac/textures/formats/Textures_forLaTeX2e.txt193
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