diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/truetex.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/base/truetex.txt | 263 |
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. --- |