summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/truetex.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/truetex.txt')
-rw-r--r--Master/texmf-dist/doc/latex/base/truetex.txt263
1 files changed, 263 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/truetex.txt b/Master/texmf-dist/doc/latex/base/truetex.txt
new file mode 100644
index 00000000000..ab7d56449b0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/base/truetex.txt
@@ -0,0 +1,263 @@
+
+ LaTeX installation instructions for TrueTeX for Windows 95/98/NT
+
+ 19 February 1999
+ (Revised 31 August 2001)
+
+SUMMARY
+=======
+
+This file (truetex.txt) is part of the LaTeX distribution, and contains
+instructions on how to install LaTeX with TrueTeX for Windows 95/98/NT.
+
+Since the TrueTeX distribution includes all of the base LaTeX macros, you
+should be installing another LaTeX base distribution only to update the LaTeX
+base macros. In fact, you may find it more convenient to simply order and
+install the lastest TrueTeX update when you want the latest LaTeX; that way
+you can get the freshest TrueTeX *and* LaTeX software with the ease and
+security of TrueTeX automatic installation.
+
+Before reading this file, you should review install.txt from the LaTeX
+distribution, which will explain how the LaTeX installation works in general.
+TrueTeX introduces very few exceptions to that generic process.
+
+This file describes the following, specifically for TrueTeX:
+
+ * How to create the LaTeX format.
+
+ * How to install the LaTeX files.
+
+ * What to do if you have any problems.
+
+REQUIREMENTS
+============
+
+In addition to the LaTeX distribution files, you will also need the file
+"hyphen.tex" (English hyphenation) and the .tfm (TeX font metric) files, which
+are included in the TrueTeX distribution and should already be installed.
+
+CONFIGURING LATEX
+=================
+
+TrueTeX is carefully designed and implemented to bring the widest
+compatibility with TeX and LaTeX to the Windows environment. We have included
+features like virtual fonts and recursive directory searching that many other
+implementations omit. The luxury of Windows virtual memory and the voluptuous
+allowances in TrueTeX remove the constraints implied by the old TeX memory
+limitations.
+
+The Unix-style configuration to which the LaTeX distribution defaults is
+appropriate and compatible with TrueTeX. TrueTeX does not require any special
+configuration to run LaTeX, such as a texsys.cfg file.
+
+Note that the earlier releases of TrueTeX used the directory \TrueTeX\macros
+for both plain TeX and LaTeX base macros. Later releases (4.1D and later)
+use the standard TeX directory structure (TDS) directory
+\TrueTeX\TeX\LaTeX\base. All of the instructions below assume you are using
+the directory \TrueTeX\TeX\LaTeX\base for the LaTeX base macros, and you
+should substitute the appropriate directory if you have an older release or a
+different starting directory.
+
+The availability of non-English hyphenation in LaTeX is controlled by a
+configuration file hyphen.cfg, which you can create to alter the LaTeX
+defaults. Creating such a file is explained elsewhere in the LaTeX
+distribution, and in references such as _The LaTeX Companion_. If you want to
+configure LaTeX for non-English hyphenation, we suggest that you create a
+bi-lingual hyphenation configuration, with language 0 (the default) as
+English, which will provide compatibility with the LaTeX documentation files,
+which are written in English.
+
+SAVING YOUR OLD VERSION OF LaTeX
+================================
+
+There are several techniques for retaining the older version of LaTeX.
+Usually, the only compelling reason to do so is to insure against trouble with
+a failed installation of the new version. If you are brave and reckless,
+you can just wipe the old files and start over with the new distribution.
+
+However, for the more conservative and cautious, if you're not concerned with
+being able to actually run the old version in parallel with the new, then we
+recommend you create a zip archive of the old macro and format files and then
+delete the unzipped versions. Another easy technique which leaves the old
+version readily accessible is to rename a subdirectory of the base directory,
+for example renaming \TrueTeX\TeX\LaTeX\base to \TrueTeX\TeX\LaTeX\oldbase or
+\TrueTeX\TeX\oldLaTeX\base; then re-creating the \TrueTeX\TeX\LaTeX\base
+directory to receive the new installation.
+
+In either case, once you are satisfied that the new LaTeX is working and
+complete, you have already separated the old version and made it easy to
+delete.
+
+UNPACKING THE DISTRIBUTION
+==========================
+
+The LaTeX project authors publish their work as a set of distribution files
+named with a .ins ("install") extension. Each such distribution file combines
+the macros and documentation for a component of LaTeX. Your first step in
+installing LaTeX is to unpack these install-files, thereby creating more
+compact versions (having the documentation stripped out).
+
+The unpacking method is unusual: To unpack the LaTeX distribution files, you
+run iniTeX (not LaTeX or plain TeX) on unpack.ins, which has a side effect of
+writing out a large set of files that make up the LaTeX macros. The procedure
+is as follows, running the TrueTeX formatter as iniTeX:
+
+ * Launch the TrueTeX formatter. Select "Cancel" on the file-open
+ dialog if that dialog appears.
+
+ * Select "Preload" (which might read "Preload=latex" or some other
+ preloaded format name) from the menu bar.
+
+ * Observe the "Select Preloaded Format File" dialog. Select "Default"
+ (which indicates you want no file preloaded) and "OK". The "Preload"
+ item on the menu bar should now read simply "Preload".
+
+ * Select File + Open, navigate to the directory where you have placed the
+ LaTeX distribution files, and type in the filename you want to
+ format, namely unpack.ins in this case.
+
+ * Select "Go" to begin the formatting. The formatter window will close
+ after it finishes, and you can examine the file unpack.log to examine
+ the messages that might have scrolled by too quickly for you to read.
+
+ This does not generate a format file; the instructions in the next section
+ create the LaTeX format file.
+
+CREATING THE LaTeX FORMAT
+=========================
+
+To create the LaTeX format file (latex.fmt) for TrueTeX, run iniTeX on
+latex.ltx. The procedure using TrueTeX is as follows:
+
+ * Follow the steps in the previous section to launch the TrueTeX
+ formatter and select no preloaded format file; except on the last
+ step, select latex.ltx as the file in the File Open dialog. This
+ will generate the format file latex.fmt and close the formatter
+ window.
+
+ * Move the file latex.fmt to the TrueTeX formats directory. Normally this
+ is c:\truetex\formats (in TrueTeX releases up to and including 4.1C) or
+ c:\truetex\truetex (in later releases). The drive and top directory
+ will be different if you chose to install TrueTeX in a different
+ directory than the default c:\truetex during TrueTeX installation.
+
+PUTTING THE FILES WHERE LaTeX CAN READ THEM
+===========================================
+
+Use the following console commands to copy the LaTeX files (which are now
+unpacked) to the appropriate inputs directory for TrueTeX (you may want to
+paste the following lines into a batch file and run them that way instead of
+typing them yourself):
+
+ copy latexbug.tex \TrueTeX\TeX\LaTeX\base
+ copy testpage.tex \TrueTeX\TeX\LaTeX\base
+ copy lablst.tex \TrueTeX\TeX\LaTeX\base
+ copy idx.tex \TrueTeX\TeX\LaTeX\base
+ copy nfssfont.tex \TrueTeX\TeX\LaTeX\base
+ copy small2e.tex \TrueTeX\TeX\LaTeX\base
+ copy sample2e.tex \TrueTeX\TeX\LaTeX\base
+ copy docstrip.tex \TrueTeX\TeX\LaTeX\base
+ copy *.cls \TrueTeX\TeX\LaTeX\base
+ copy *.clo \TrueTeX\TeX\LaTeX\base
+ copy *.sty \TrueTeX\TeX\LaTeX\base
+ copy *.fd \TrueTeX\TeX\LaTeX\base
+ copy *.def \TrueTeX\TeX\LaTeX\base
+ copy *.cfg \TrueTeX\TeX\LaTeX\base
+ copy *.ist \TrueTeX\TeX\LaTeX\base
+
+ Note: the LaTeX base directory is \truetex\macros instead of
+ \TrueTeX\TeX\LaTeX\base in TrueTeX releases 4.1C and earlier.
+
+CHECKING THAT THE INSTALLATION WORKED
+=====================================
+
+You now have a new working LaTeX installed. If you had a LaTeX icon
+specifying "&latex" in the command-line as an option, it should automatically
+use the new LaTeX. You should also be able to select the preloaded format
+latex.fmt using the Preload item in the formatter menu by selecting the Search
+button.
+
+Launch LaTeX and format the file ltxcheck.tex from the LaTeX distribution.
+This will produce some `OK' and the following `BAD' warnings, which you can
+ignore:
+
+ "article.cls appears to be in current directory! ... ! BAD: This file
+ should not be run in a `standard input directory'."
+
+ EXPLANATION: If article.cls is not in the current directory (that is, the
+ directory where you navigated to open ltxcheck.lts) this can be a false
+ alarm, due to the fact that LaTeX is not aware that the TrueTeX formatter
+ (release 4.1C or earlier) did path-searching for input files, even if when
+ file names indicated the current directory. This lack of awareness does
+ not affect normal operation of LaTeX. If you are running release 4.1D or
+ later of the formatter, you should not see this message, unless article.cls
+ is indeed in the current directory. If you really want to know where the
+ formatter is finding the file article.cls, select "Debug+Show File Opens"
+ and run the format of ltxcheck.ltx again.
+
+ "! BAD: No ec fonts found!! ... LaTeX does not require the use of ec
+ fonts however they are strongly recommended."
+
+ - or -
+
+ "! BAD dc fonts 1.2 or older installed.
+ Current (as of 1997/01/14) dc font release is 1.3.
+ These dc fonts may be obtained from CTAN archives, in:
+ tex-archive/fonts/dc.
+ They are expected to be replaced by ec fonts very soon."
+
+ EXPLANATION: TrueTeX does not supply the dc fonts release 1.2 or the ec
+ fonts, although a dc fonts release 1.1 is available. Regrettably, the
+ later releases of the METAFONT bitmap fonts were re-designed such that the
+ font name is used to indicate the font's optical scaling, which is an
+ irrational scheme generally incompatible with scalable font technology such
+ as is used in TrueType or ATM. (Later releases multiplied optical sizes to
+ the point that lately there are over 500 EC fonts, which is an impossible
+ amount of effort to convert to scalable form or to reliably install in
+ Windows.) If you want to use the TrueTeX dc fonts release 1.1, run the
+ olddc.ins through initex and move the resulting files to the TrueTeX inputs
+ directory.
+
+ "The LaTeX2e installation has installed fd files for release 1.2 (or
+ later) of the dc fonts. However, you appear to have only release 1.1 of
+ these fonts. You must now generate the correct fd files by running:
+ latex olddc.ins and then rebuild the format by rerunning: initex
+ latex.ltx ... ! BAD LaTeX2e system!!."
+
+ EXPLANATION: You no doubt forgot to run olddc.ins through iniTeX before
+ generating the LaTeX format file.
+
+ "The fd files for the obsolete release 1.1 of the
+ dc fonts have been loaded into the LaTeX format.
+ However, you appear to have at least release 1.2 of the dc fonts.
+ You should generate suitable fd files by running ..."
+
+ EXPLANATION: You probably have the DC 1.2 metric files (*.tfm's, which is
+ all ltxcheck.ltx is looking for) from some other source. But you won't
+ have the actual TrueType fonts (not from TrueTeX, anyway; they don't exist,
+ at least not yet). Leave the selection of the release 1.1 names in place;
+ *don't* take the advice to "generate suitable fd files".
+
+PROBLEMS
+========
+
+If you get error messages regarding missing fonts lcircle10 and lcirclew10,
+use the Winodws 95/98/NT console to copy the 8-character names to the longer
+names:
+
+ cd \truetex\fonts
+ copy lcircle1.tfm lcircle10.tfm
+ copy lcirclw1.tfm lcirclew10.tfm
+
+You may report additional problems installing LaTeX with TrueTeX to the
+publisher's e-mail address given in the "About" dialog of either the TrueTeX
+formatter or previewer, which as of this writing is: kinch@truetex.com.
+
+CLEARING UP
+===========
+
+Consult the install.txt instructions for removing unneeded LaTeX distribution
+files.
+
+ --- Copyright 1997, 1999 Richard J Kinch and the LaTeX3 project ---
+ --- All rights reserved. ---