LaTeX installation instructions for TrueTeX for Windows 95/98/NT

                               19 February 1999

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.

   Normally there are no *.cfg files to install for TrueTeX.

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: [email protected].

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.                    ---