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, 0 insertions, 263 deletions
diff --git a/Master/texmf-dist/doc/latex/base/truetex.txt b/Master/texmf-dist/doc/latex/base/truetex.txt
deleted file mode 100644
index ab7d56449b0..00000000000
--- a/Master/texmf-dist/doc/latex/base/truetex.txt
+++ /dev/null
@@ -1,263 +0,0 @@
-
- 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. ---