7               LaTeX installation TeX expert information    &                           11 June 1995       SUMMARY  =======    D This document contains information about the LaTeX installation for ) TeX experts.  In particular it describes:    '  * The checks performed by ltxcheck.tex    !  * How to print the LaTeX source.    . For more general information, see install.txt.   7 For information on configuring LaTeX see cfgguide.tex.       THE LTXCHECK.TEX CHECKS  =======================    4 Here is a description of the checks run by ltxcheck.    1) The \@currdir check.   G    It is useful for LaTeX to know the syntax for the `current directory E    (or folder)', or `default directory', if  the operating system has     such a concept.   G    For example, file abc.tex in this directory, or folder, is specified     by:0      ./abc.tex   on Unix and most DOS/OS2 TeX's,      []abc.tex   on VMS         :abc.tex   on a Macintosh.A    The above possibilities will be found automatically during the B    installation.  However, if none of these syntaxes works on yourC    system then the internal macro \@currdir will be set to be empty !    and ltxcheck will report this.    D    If your system does have a notion of a current directory, you can+    define \@currdir in the file texsys.cfg.    ?    You could also report this to the latex-bug address, so that :    later releases can automatically cope with your system.    2) The \input@path check.   @    On some systems TeX cannot check whether a file exists beforeF    trying to input it, unless the filename is expressed as a full pathE    name, including the directory.  On these systems LaTeX needs to be >    given a list of directories in which to look for files; the5    internal macro \input@path holds this information.    >    When run, ltxcheck will try to locate the file article.cls.?    If it fails to find this file (and you have placed it in the B    `standard input directory') then you must define \input@path in    the file texsys.cfg.    F    The files texsys.cfg and dircheck.dtx contain examples of how to doH    this but only you know the directories and syntax that should be used    for your installation.    @    We hope to build up a better collection of examples in future:    releases of LaTeX, as it is tested on more TeX systems.    3) TeX version check.   E    The next check tests that you are running a recent version of TeX. A    If ltxcheck reports that you have TeX2, then you should try to E    upgrade TeX (and rebuild LaTeX) as soon as possible.  LaTeX may be D    used with TeX2, but certain features will be missing and you will@    not be able to use the new (8-bit) font families that are now
    available.    E    If ltxcheck reports that your TeX version is older than 3.141, you C    will see some strange messages during the installation.  This is A    because earlier versions of TeX printed certain line-breaks in E    messages on the terminal as `^^J' rather than starting a new line.    C    LaTeX will work round this bug and thus avoid `^^J' appearing in =    error messages, but you should upgrade your TeX as soon as C    possible, as other bugs have been fixed, not just line breaks in     messages.  A    At the present time (1995) the current TeX version is 3.14159.    4) Fonts check.   E    Finally ltxcheck.tex tests to see if it can find a `representative &    sample' of the fonts used by LaTeX.  %    Fonts that may cause problems are: F    a) The circle fonts. These were renamed some years ago from circle*D       to lcircle*, although some sites still have them under the oldD       name. Also the names are longer than 8 letters which may cause       some problems.B    b) The `extra Computer Modern' fonts. The American MathematicalG       Society has extended the range of sizes available in the Computer >       Modern fonts. LaTeX now assumes these extra cm fonts are@       available. They are available from ctan:macros/latex/fontsF       or alternatively as part of the AMS fonts collection, which also.       includes many useful mathematical fonts.     DOCUMENTATION OF THE CODE  =========================    D To typeset a documented code file (a .dtx file) you simply run LaTeX@ on it. The file source2e.tex is a master file which produces the@ documented code for the whole LaTeX kernel (but not the standardD packages, classes, or compatibility mode).  You need to have LaTeX2e installed before doing this.   A To configure the appearance of this documentation, you can use a  D ltxdoc.cfg file.  For example, putting the following line into this 0 file will format the documentation for A4 paper:   (    \PassOptionsToClass{a4paper}{article}   A The doc package, which is used by the documentation files, writes A index files and change-history files that can be processed by the E program MakeIndex.  If this program is part of your TeX installation, A you can get an index and history listing for a documentation file 8 by running the .idx and .glo files through this program.   / For example, in Unix MakeIndex, you should say:    !    makeindex -s gind.ist FILENAME 5    makeindex -s gglo.ist -o FILENAME.gls FILENAME.glo   E source2e.tex uses a special source2e.ist file (in place of gind.ist). A See the comments at the end of source2e.tex for more information.       CONFIGURING LaTeX  =================   @ In addition to the system-dependent customisation in texsys.cfg,C various other parts of LaTeX can be configured to suit local needs. > Further details can be found in the document cfgguide.tex.  WeD recommend that you install the standard system before attempting any further customisation.  E If you are thinking of making other changes to LaTeX, please read the F document modguide.tex as it describes the precautions you need to take@ when making modifications in order to ensure that standard LaTeX& remains a stable, maintainable system.     FURTHER INFORMATION  ===================   C You will find further information about various aspects of LaTeX in = the distributed files with names <*>guide.tex.  You will need > to install the new version before you can typeset these files.     ? --- Copyright 1995 the LaTeX3 project.  All rights reserved --- 