home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 August / PCWorld_1999-08_cd.bin / doc / HOWTO / TeTeX-HOWTO < prev    next >
Text File  |  1998-11-29  |  99KB  |  2,641 lines
  1.   The teTeX HOWTO: The Linux-teTeX Local Guide
  2.   Robert Kiesling
  3.   v3.7, 9 November 1998
  4.  
  5.   This document covers the basic installation and usage of the teTeX TeX
  6.   and LaTeX implementation under the major U.S. Linux distributions, and
  7.   auxiliary packages like Ghostscript.  Contents of the teTeX HOWTO: The
  8.   Linux-teTeX Local Guide are Copyright (C) 1997, 1998 by Robert A.
  9.   Kiesling.  The exact terms of copying are given in the introduction
  10.   and the appendices.  Registered trademarks are the property of their
  11.   respective owners.  Please send all complaints, suggestions, errata,
  12.   and any miscellany to kiesling@ix.netcom.com, so I can keep this docu¡
  13.   ment as complete and up to date as possible.
  14.   ______________________________________________________________________
  15.  
  16.   Table of Contents
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.   1. Introduction.
  68.  
  69.      1.1 Copyright.
  70.      1.2 Software described in this document.
  71.         1.2.1 teTeX.
  72.         1.2.2 Text editors.
  73.         1.2.3 (TT
  74.         1.2.4 Fonts.
  75.  
  76.   2. Using teTeX.
  77.  
  78.      2.1 Printing the documentation.
  79.  
  80.   3. TeX commands.
  81.  
  82.      3.1 Command overview.
  83.      3.2 Font commands.
  84.      3.3 Paragraph styles and dimensions.
  85.         3.3.1 Tolerances.  (What are those black rectangles after every line?)
  86.      3.4 Page layout.
  87.      3.5 Page numbers, headers, and footers.
  88.      3.6 Titles and macros.
  89.  
  90.   4. LaTeX commands.
  91.  
  92.      4.1 Document structure.
  93.      4.2 Characters and type styles.
  94.      4.3 Margins and line spacing.
  95.      4.4 Document classes.
  96.         4.4.1 Articles and reports.
  97.         4.4.2 Letters.
  98.  
  99.   5. LaTeX extension packages and other resources.
  100.  
  101.   6. Mixing text and graphics with
  102.  
  103.      6.1 What if my printer isn't supported?
  104.  
  105.   7. Using Postscript fonts.
  106.  
  107.   8. Appendix A: CTAN site list.
  108.  
  109.   9. Appendix B: Installing the CTAN teTeX distribution.
  110.  
  111.      9.1 Installing the binary distribution.
  112.         9.1.1 Minimal installation.
  113.         9.1.2 Complete installation.
  114.      9.2 Base system configuration.
  115.      9.3 Installing the CTAN source distribution.
  116.      9.4 Post-installation configuration details.
  117.  
  118.   10. Appendix C: Distribution and Copyright.
  119.  
  120.      10.1 Distribution.
  121.      10.2 GNU GENERAL PUBLIC LICENSE
  122.      10.3 How to Apply These Terms to Your New Programs
  123.  
  124.  
  125.   ______________________________________________________________________
  126.  
  127.   1.  Introduction.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.   1.1.  Copyright.
  134.  
  135.   The teTeX-HOWTO is copyright (C) 1997, 1998 by Robert Kiesling.
  136.   Permission is granted to make and distribute verbatim copies of this
  137.   manual provided that the copyright notice and this permission notice
  138.   are preserved on all copies.
  139.  
  140.   Permission is granted to copy and distribute modified versions of this
  141.   manual under the conditions for verbatim copying, provided also that
  142.   the sections entitled, ``Distribution,'' and, ``GNU General Public
  143.   License,'' are included exactly as in the original, and provided that
  144.   the entire resulting derived work is distributed under the terms of a
  145.   permission notice identical to this one.
  146.  
  147.   Permission is granted to copy and distribute translations of this
  148.   manual into another language, under the above conditions for modified
  149.   versions.  except that the sections entitled, ``Distribution,'' and,
  150.   ``GNU General Public License,'' may be included in a translation
  151.   approved by the Free Software Foundation instead of in the original
  152.   English.  Please refer to Section ``Distribution and Copyright'' for
  153.   terms of copying.
  154.  
  155.  
  156.   1.2.  Software described in this document.
  157.  
  158.   TeX handles only the formatting part of the document preparation.
  159.   Generating output from TeX is like compiling source code into object
  160.   code, which still needs to be linked.  You prepare an input file with
  161.   a text editor----what most people think of as ``word processing''---
  162.   and format the input file document with TeX to produce a device-
  163.   independent output file, called a .dvi file.
  164.  
  165.   You also need a program or two to translate TeX's .dvi output for your
  166.   screen and printer.  These programs are collectively known as
  167.   ``dviware.''  For example, TeX itself only makes requests for fonts.
  168.   It is up to the .dvi output translator to provide the actual font for
  169.   the output regardless of whether the medium is a video screen or
  170.   paper.  This extra step may seem overly complicated, but the
  171.   abstraction allows documents to display the same on different devices
  172.   with little or no change to the original document.
  173.  
  174.  
  175.  
  176.  
  177.   1.2.1.  teTeX.
  178.  
  179.   TeX is implemented for practically every serious computer system in
  180.   the world---and quite a few ``non-serious'' ones---so implementors
  181.   must provide the installation facilities for all of them.  This
  182.   accounts in part for teTeX's complexity, in addition to the inherent
  183.   complexity of any TeX installation.  It also accounts for the fact
  184.   that installing the system yourself is a significant task, and unless
  185.   you are already familiar with TeX, it is easy to get lost in the
  186.   numerous executable programs, TeX files, documentation, and fonts.
  187.  
  188.   Fortunately, teTeX is part of the GNU/Linux distribution. You can
  189.   install the package much more easily using GNU/Linux installation
  190.   tools. You may already have teTeX installed on your system.  If so,
  191.   you can skip ahead to Section ``Using teTeX''.
  192.  
  193.   However, if you want to install the package, the archives necessary
  194.   for a workable teTeX installation are on the CTAN archive network.
  195.   There is a list of these sites in Section ``CTAN site list''.
  196.  
  197.   CTAN is the Comprehensive TeX Archive Network, a series of anonymous
  198.   FTP sites that archive TeX programs, macros, fonts, and documentation.
  199.   In the course of using TeX you'll probably become familiar with at
  200.   least one CTAN site.  In this document, a pathname like
  201.   ~CTAN/contrib/pstricks means ``look in the directory contrib/pstricks
  202.   of your nearest CTAN site.''
  203.  
  204.   The installation of the generic teTeX distribution described in
  205.   Section ``Installing the CTAN teTeX distribution'' concentrates on the
  206.   Intel versions of Linux.  Installing teTeX on other hardware should
  207.   require only substituting the appropriate executable program archive
  208.   in the installation process.
  209.  
  210.   In addition to the executable programs, the distribution includes all
  211.   of the TeX and LaTeX package, metafont and its sources, bibtex,
  212.   makeindex, and all of the documentation... more than 4 megabytes'
  213.   worth.  The documentation covers everything you will forseeably need
  214.   to know to get started.  So, you should install all of the documents.
  215.   Not only will you eventually read them, the documents themselves
  216.   provide many examples of ``live'' TeX and LaTeX code.
  217.  
  218.   TeX was written by Professor Donald Knuth of Stanford University.  It
  219.   is a lower-level typesetting language for all of the higher-level
  220.   packages like LaTeX.  Essentially, LaTeX is a set of TeX macros that
  221.   provide convenient, predefined document formats for end users.  If you
  222.   like the formats provided by LaTeX, you may never need to learn bare-
  223.   bones TeX programming.  The difference between the two languages is
  224.   like the difference between assembly language and C.  You can have the
  225.   speed and flexibility of TeX, or the convenience of LaTeX.
  226.  
  227.   By the way, the letters of the word ``TeX'' are Greek, tau-epsilon-
  228.   chi.  It is not a fraternity, but the root of the Greek word, techne,
  229.   which means art and/or science.  ``TeX'' is not pronounced like the
  230.   first syllable in ``Texas.''  The chi has no English equivalent, but
  231.   TeX is generally pronounced so that it rhymes with ``yecch,'' to use
  232.   Professor Knuth's example from The TeXBook, which is one of the
  233.   standard TeX references.  When writing, ``TeX,'' on character devices,
  234.   always use the standard capitalization, or the \TeX{} macro in
  235.   typesetting.
  236.  
  237.  
  238.   1.2.2.  Text editors.
  239.  
  240.   Any of the editors that work under Linux---jed, joe, jove, vi, vim,
  241.   stevie, Emacs, and microemacs---will work to prepare a TeX input file,
  242.   as long as the editor reads and writes plain-vanilla ASCII text.  My
  243.   preference is GNU Emacs.  There are several reasons for this:
  244.  
  245.   ╖  You can format, preview and print documents with Emacs's TeX and
  246.      LaTeX modes.
  247.  
  248.   ╖  Emacs can automatically insert TeX-style, ``curly quotes,'' as you
  249.      type, rather than the "ASCII-vanilla" kind.
  250.  
  251.   ╖  Emacs has integrated support for Texinfo, a hypertext documentation
  252.      system.
  253.  
  254.   ╖  Emacs is widely supported.  Versions 19.34 and later, for example,
  255.      are included in the major U.S. Linux distributions.  The most
  256.      recent version from the GNU archives is 20.3.
  257.  
  258.   ╖  Emacs does everything except butter the toast in the morning.
  259.  
  260.   ╖  Emacs is free.
  261.  
  262.  
  263.  
  264.  
  265.   1.2.3.  dvips .
  266.  
  267.   Tomas Rokicki's dvips generates Postscript from a .dvi file.  In
  268.   addition, it runs Metafont if necessary to generate the bit mapped
  269.   fonts it needs or uses Postscript fonts for the output.  It can also
  270.   crop and resize pages and perform graphics translations from
  271.   instructions in a TeX or LaTeX file,
  272.  
  273.   The dvips program is part of the teTeX distribution.  It is discussed
  274.   fully in Section ``Mixing text and graphics with <tt>dvips</tt>''
  275.  
  276.  
  277.   1.2.4.  Fonts.
  278.  
  279.   Much of TeX's, and therefore LaTeX's, complexity, arises from its
  280.   implementation of various font systems, and the way these fonts are
  281.   specified.  A major improvement of LaTeX 2e over its predecessor was
  282.   the way users specify fonts, the former New Font Selection Scheme.
  283.   They're discussed in Section ``Characters and type styles'', Section
  284.   ``TeX Font Commands'', and Section ``Using Postscript fonts''.)
  285.  
  286.   teTeX comes distributed with about a dozen standard fonts preloaded,
  287.   which is enough to get you started.  Also provided are the font
  288.   metrics descriptions, in .tfm (TeX font metric) files.  To generate
  289.   the other fonts that you need, it is simply a matter of installing the
  290.   metafont sources.  teTeX's .dvi utilities will invoke metafont
  291.   automatically and generate the Computer Modern fonts you need.
  292.  
  293.  
  294.   2.  Using teTeX.
  295.  
  296.   Theoretically, at least, everything is installed correctly and is
  297.   ready to run.  teTeX is a very large software package.  As with any
  298.   complex software package, you'll want to start by learning teTeX
  299.   slowly, instead of being overwhelmed by its complexity.
  300.  
  301.   At the same time, we want the software to do something useful.  So
  302.   instead of watching TeX typeset
  303.  
  304.   ``Hello, World!''
  305.  
  306.  
  307.   as Professor Knuth suggests, we'll produce a couple of teTeX's own
  308.   documents in order to test it.
  309.  
  310.  
  311.   2.1.  Printing the documentation.
  312.  
  313.   You should be logged in as root the first few times you run teTeX.  If
  314.   you aren't, Metafont may not be able to create the necessary
  315.   directories for its fonts.  The texconfig program includes an option
  316.   to make the font directories world-writable, but if you're working on
  317.   a multi-user system, security considerations may make this option
  318.   impractical or undesirable.
  319.  
  320.   In either instance, if you don't have the appropriate permissions to
  321.   write to the directories where the fonts are stored, Metafont will
  322.   complain loudly because it can't make the directories.  You won't see
  323.   any output because you have a bunch of zero-length font characters.
  324.   This is no problem.  Simply log out, re-login as root, and repeat the
  325.   offending operation.
  326.  
  327.   The nice thing about teTeX is that, if you blow it, no real harm is
  328.   done.  It's not like a compiler, where, say, you will trash the root
  329.   partition if a pointer goes astray.  What, you haven't read the teTeX
  330.   manual yet?  Of course you haven't.  It's still in the distribution,
  331.   in source code form, waiting to be output.
  332.  
  333.   So, without further delay, you will want to read the teTeX manual.
  334.   It's located in the directory
  335.  
  336.   /usr/lib/teTeX/texmf/doc/tetex.
  337.  
  338.  
  339.  
  340.   The LaTeX source for the manual is called TETEXDOC.tex.  (The .tex
  341.   extension is used for both TeX and LaTeX files.  Some editors, like
  342.   Emacs, can tell the difference.)  There is also a file TETEXDOC.dvi
  343.   included with the distribution, which you might want to keep in a safe
  344.   place---say, another directory ---in case you want to test your .dvi
  345.   drivers later.  With that out of the way, type
  346.  
  347.   latex TETEXDOC.tex
  348.  
  349.  
  350.   LaTeX will print several warnings.  The first,
  351.  
  352.   LaTeX Warning: Label(s) may have changed. Rerun to get the
  353.   cross-references right.
  354.  
  355.  
  356.   is standard.  It's common to build a document's Table of Contents by
  357.   LaTeXing the document twice.  So, repeat the command.  The other warn¡
  358.   ings can be safely ignored.  They simply are informing you that some
  359.   of the FTP paths mentioned in the documentation are too wide for their
  360.   alloted spaces.  Sections ``Paragraph styles and dimensions'' and
  361.   ``Tolerances'' describe horizontal spacing in more detail.
  362.  
  363.   teTeX will have generated several files from TETEXDOC.tex.  The one
  364.   that we're interested in is TETEXDOC.dvi. This is the device-
  365.   independent output which you can send either to the screen or the
  366.   printer.  If you're running teTeX under the X Windows System, you can
  367.   preview the document with xdvi.
  368.  
  369.   For the present, let's assume that you have a HP LaserJet II.  You
  370.   would give the command
  371.  
  372.   dvilj2 TETEXDOC.dvi
  373.  
  374.  
  375.   which writes a PCL output file from TETEXDOC.dvi, including soft fonts
  376.   which will be downloaded to the LaserJet.  This is not a feature of
  377.   TeX or LaTeX, but a feature provided by dvilj2.  Other .dvi drivers
  378.   provide features that are relevant to the devices they support.
  379.   dvilj2 tries to fill the font requests which were made in the original
  380.   LaTeX document with the the closest equivalents available on the sys¡
  381.   tem.  In the case of a plain text document like TETEXDOC.tex, there
  382.   isn't much difficulty.  All of the fonts requested by TETEXDOC.tex
  383.   will be generated by metafont, which is automatically invoked by
  384.   dvilj2, if the fonts aren't already present.  (If you're running
  385.   dvilj2 for the first time, the program may need to generate all of the
  386.   fonts.)  There are several options that control font generation via
  387.   dvilj2.  They're outlined in the manual page.  At this point, you
  388.   shouldn't need to operate metafont directly.  If you do, then some¡
  389.   thing has gone awry with your installation.  All of the .dvi drivers
  390.   will invoke metafont directly via the kpathsea path-searching
  391.   library---the discussion of which is beyond the scope of this docu¡
  392.   ment---and you don't need to do any more work with metafont for the
  393.   present---all of the metafont sources for the Computer Modern font
  394.   library are provided.
  395.  
  396.  
  397.   You can print TETEXDOC.lj with the command
  398.  
  399.   lpr TETEXDOC.lj
  400.  
  401.  
  402.   You may also need to install a printer filter that understands PCL.
  403.  
  404.   The nine-page teTeX Guide provides some useful information for further
  405.   configuring your system, some of which I have mentioned, much that
  406.   this document doesn't cover.
  407.  
  408.   Some of the information in the next section I haven't been able to
  409.   test, because I have a non-Postscript HP Deskjet 400 color ink jet
  410.   printer connected to the computer's parallel port.  However, not
  411.   owning a Postscript printer is no barrier to printing text and
  412.   graphics from your text documents.  Ghostscript is available in most
  413.   Linux distributions and it could already be installed on your system.
  414.  
  415.  
  416.   3.  TeX commands.
  417.  
  418.   Preparing documents for TeX typesetting is easy.  Make sure there's a
  419.   blank line between the paragraphs of a plain text file, and run file
  420.   through the TeX program with the command
  421.  
  422.   tex your_text_file
  423.  
  424.  
  425.   The result will be a file of the same base name and the extension
  426.   .dvi.  TeX formats the text in 10-point, Computer Modern Roman, sin¡
  427.   gle-spaced, with justified left and right margins.  If you receive
  428.   error messages from special characters like dollar signs, escape them
  429.   with a backslash character, \, and run TeX on the file again.  You
  430.   should be able to process the resulting file with the .dvi file trans¡
  431.   lator of your choice (see above) to get printed output.
  432.  
  433.   One peculiarity of TeX input is that you must use opening and closing
  434.   quotes, which are denoted in the input file with the grave accent and
  435.   single quote characters.  Emacs' TeX mode does this for you
  436.   automatically.
  437.  
  438.   "These are ASCII-type quotes."
  439.   ``These are `TeX-style' quotes.''
  440.  
  441.  
  442.  
  443.  
  444.   3.1.  Command overview.
  445.  
  446.   Commands in TeX start with a backslash (``\'').  For example, the
  447.   command to change the spacing between lines is
  448.  
  449.   \baselineskip=24pt
  450.  
  451.  
  452.  
  453.   The baseline is the bottom of the characters on a line, not counting
  454.   descenders.  The distance between the baseline of one line and the
  455.   next is the \baselineskip, and is assigned a value of 24 points.
  456.  
  457.   Measurements or dimensions in TeX are often given in the following
  458.   units:
  459.  
  460.  
  461.  
  462.  
  463.   pt                % Point        1/72 in.
  464.   pc                % Pica:        12 pt.
  465.   in                % Inch:        72.27 pt.
  466.   cm                % Centimeter:  2.54 cm = 1 in.
  467.   mm                % Millimeter:  10 mm = 1 cm.
  468.  
  469.  
  470.  
  471.   Some commands do not take assignments.  For example:
  472.  
  473.   \smallskip        % Approximately 3 pt.
  474.   \medskip          % Two \smallskips.
  475.   \bigskip         % Two \medskips.
  476.  
  477.  
  478.  
  479.   A \smallskip inserts a 3 pt. vertical space in the document.  The
  480.   measurements are approximate because TeX needs to adjust the
  481.   dimensions for page breaks, section headings, and other units of
  482.   vertical space.  This is true for horizontal spacing as well.
  483.  
  484.   \hsize=6.5in
  485.  
  486.  
  487.   This command sets the line length to a width of 6.5 inches.  TeX tries
  488.   to fill the line by adjusting the spacing between words, and some let¡
  489.   ters.  If TeX cannot fill a line to within its tolerances, it produces
  490.   a warning message, and adjusts the horizontal spacing within the line
  491.   as best it can.  Formatting tolerances are discussed in Section ``Tol¡
  492.   erances''.
  493.  
  494.   There are many other commands that specify horizontal and vertical
  495.   dimensions and tolerances, and the most commonly use commands are
  496.   described below.
  497.  
  498.  
  499.   3.2.  Font commands.
  500.  
  501.   In TeX, the default font is 10 pt. Computer Modern Roman.  To specify
  502.   a typeface, like italic, bold, or monospaced, use the following
  503.   commands.
  504.  
  505.   \rm          % Roman (the default).
  506.   \it          % Italics.
  507.   \bf         % Bold.
  508.   \tt         % Monospaced (teletype).
  509.   \sl          % Oblique (slanted).
  510.  
  511.  
  512.   The commands change the typeface where they appear in the text, as in
  513.   this example.
  514.  
  515.   This text is Roman, \it and this text is italic.  \bf This text is
  516.   bold, and \rm this text is in Roman again.
  517.  
  518.  
  519.  
  520.   To specify a font for your document, use the\font command.
  521.  
  522.   \font\romantwelve=cmr12
  523.  
  524.  
  525.   This creates the font command \romantwelve, which, when used in the
  526.   text, changes the font to Computer Modern Roman, 12 point.
  527.  
  528.  
  529.   \romantwelve
  530.   This is the Computer Modern Roman font at 12 points.
  531.  
  532.  
  533.   For information about the fonts in the teTeX distribution look at the
  534.   file:
  535.  
  536.   /usr/lib/teTeX/texmf/doc/fonts/fontname/fontname.dvi
  537.  
  538.  
  539.  
  540.   If you want to print a sample of a font, TeX the file
  541.  
  542.   /usr/lib/teTeX/texmf/tex/plain/base/fontchart.tex
  543.  
  544.  
  545.   and fill in the name of the font you want to print at the prompt.
  546.  
  547.   You can also change the size of a font to get different effects.  Font
  548.   magnification is exponential, and specified with the scaled \magstep
  549.   command, which is placed after the font specification.
  550.  
  551.   \font\sfmedium=cmss12 scaled \magstep 1
  552.  
  553.  
  554.   This command will give you a sans serif font that is 120 percent the
  555.   size of the 12-point Computer Modern sans serif font.  Fonts can be
  556.   magnified in steps from 0 to 5.  Each step provides and additional 120
  557.   percent magnification.
  558.  
  559.  
  560.   3.3.  Paragraph styles and dimensions.
  561.  
  562.   As mentioned above, TeX typesets text in 10-point Computer Modern
  563.   Roman by default.  The length of a line is the value of \hsize, which
  564.   defaults to 6.5 in.  If you want to change the value of \hsize to 5.5
  565.   in. for example, use this command.
  566.  
  567.   \hsize=5.5in
  568.  
  569.  
  570.  
  571.   In TeX a dimension is an adjustable unit of length, either horizontal
  572.   or vertical.  The amount by which a dimension can be increased or
  573.   decreased can be specified in its definition.  Closely related to a
  574.   dimension is a skip, which is a dimension that is placed in one of
  575.   TeX's internal registers.  Skips are defined with the \newskip
  576.   command.  The \smallskip dimension, as defined by TeX is:
  577.  
  578.   \newskip\smallskipamount \smallskipamount=3pt plus 1pt minus 1pt
  579.  
  580.  
  581.   The \smallskip command is shorthand for:
  582.  
  583.   \vskip\smallskipamount
  584.  
  585.  
  586.  
  587.   There are a number of dimensions that control the page layout.  They
  588.   are summarized in Section ``Page layout''.
  589.  
  590.   TeX formats paragraphs with justified left and right margins.  If you
  591.   want the text to be left justified only, use this command:
  592.  
  593.   \raggedright
  594.  
  595.   To typeset a line that is justified to the right margin, use the
  596.   \rightline command:
  597.  
  598.   \rightline{This is the line to be typeset.}
  599.  
  600.  
  601.  
  602.   The \line command typesets the text of its argument to fill the entire
  603.   line.
  604.  
  605.   \line{This text will be spaced to fit the entire line.}
  606.  
  607.  
  608.  
  609.   The \hfil command adds space to fill out the line where it occurs.
  610.   So, for example, the \rightline command is equivalent to:
  611.  
  612.   \line{\hfilThis line will be right justified.}
  613.  
  614.  
  615.  
  616.   To typeset a line that is centered, use the \centerline command.
  617.  
  618.   \centerline{This is the line to be centered.}
  619.  
  620.  
  621.  
  622.   To change the left margin, set the value of \hoffset, as in this
  623.   example:
  624.  
  625.   \hoffset=1.5in
  626.  
  627.  
  628.  
  629.   The \parindent command specifies the amount that the first line of
  630.   every paragraph is indented.
  631.  
  632.   \parindent=.5in
  633.  
  634.  
  635.  
  636.   Two other dimensions, \leftskip and \rightskip, will indent the right
  637.   and left margins, respectively, of the paragraphs that come after
  638.   them.
  639.  
  640.   \leftskip=.5in
  641.   \rightskip=.5in
  642.  
  643.  
  644.   The control word \narrower is equivalent to:
  645.  
  646.   \leftskip=\parindent
  647.   \rightskip=\parindent
  648.  
  649.  
  650.   That is, \narrower narrows the paragraph margins by the value of
  651.   \parindent
  652.  
  653.   As mentioned in the previous section, the \baselineskip specifies the
  654.   distance between lines.  The default is 12 pt.  To approximate double-
  655.   spaced text, use the following command.
  656.  
  657.   \baselineskip=\baselineskip*1.6
  658.  
  659.  
  660.  
  661.   The \parskip command specifies the distance in addition to
  662.   \baselineskip between paragraphs.  By default, no extra space is
  663.   added, but the distance between paragraphs can stretch as much as 1
  664.   pt. to fill the page correctly.  To put a blank line between
  665.   paragraphs, use this command:
  666.  
  667.   \parskip=\baselineskip
  668.  
  669.  
  670.  
  671.  
  672.   3.3.1.  Tolerances.  (What are those black rectangles after every
  673.   line?)
  674.  
  675.   TeX normally formats text to strict tolerances.  If, for some reason,
  676.   text cannot be formatted to within those tolerances, TeX produces a
  677.   warning message and formats the text the best it can.  If the text
  678.   must be stretched too much to fit the line, TeX warns you that the
  679.   \hbox is underfull.  Text that must be squeezed to fit in the line
  680.   produces an overfull \hbox warning.
  681.  
  682.   For each overfull \hbox, TeX places a slug, a black rectangle, after
  683.   the line.  The slug indicates that the line could not be formatted to
  684.   within the specifications set by the \hbadness parameter.
  685.  
  686.   The fit of the text within its specified dimensions is measured by its
  687.   badness, which is a number between 0 and 10000.  A badness of 0 is a
  688.   perfect fit, and a badness of 10000 means that the line probably will
  689.   never fit.  The default value of \hbadness is 1000.  If you set
  690.   \hbadness to 10000, TeX does not report underfull lines.
  691.  
  692.   Sometimes TeX allows a line to extend past the right margin.  This is
  693.   an aesthetic decision on the part of TeX's author.  The amount is
  694.   determined by the \hfuzz parameter, which defaults to 0.1 pt.  If the
  695.   text does not fit within the line, the \tolerance parameter determines
  696.   how TeX will handle the overfull \hbox.  The default value of
  697.   \tolerance is 200.  Setting \tolerance to 1000 suppresses overfull
  698.   \hbox warnings and the printing of slugs.
  699.  
  700.  
  701.   3.4.  Page layout.
  702.  
  703.   In addition to the left margin and line length dimensions that are
  704.   described in the previous section, TeX also lets you specify top and
  705.   bottom margins, and vertical spacing.
  706.  
  707.   Like the \hsize and \hoffset dimensions described in the previous
  708.   section, TeX also provides the \vsize and \voffset commands.  The
  709.   default for \vsize is 8.9 in., and \voffset defaults to 0.
  710.  
  711.   Normally, teTeX places the beginning of the first line of text 1 in.
  712.   below the top of the paper and 1 in. from the left edge.  You can
  713.   start the text closer to the top of the page with the command:
  714.  
  715.   \voffset=-0.5in
  716.  
  717.  
  718.  
  719.   If you want to add vertical space in a document, the commands
  720.   \smallskip, \medskip, and \bigskip will add approximately 3, 6, and 12
  721.   points of blank vertical space.  These measurements are approximate;
  722.   TeX will adjust them by as much as 1 pt. so the page is filled
  723.   correctly.
  724.  
  725.   The \vfill command adds an adjustable vertical space between
  726.   paragraphs on a page.  It is infinitely stretchable, so it will add
  727.   vertical space to fill as much of the rest of the page as possible.
  728.   If you want to specify a dimension, use \vskip as in:
  729.  
  730.   \vskip 10pt
  731.  
  732.  
  733.  
  734.   The commands \hss and \vss are similar to \hfil and \vfill, but they
  735.   provide dimensions that are infinitely shrinkable as well as
  736.   infinitely stretchable.
  737.  
  738.   The \vskip and \vfill commands produce flexible lengths.  They do not
  739.   add space where no text exists; for example, at the top of a page.
  740.   Use \vglue if you want to add an absolute space.
  741.  
  742.   TeX fills the \vsize dimension with as much text as possible before it
  743.   starts a new page.  To force a page break, use the \vfill \eject
  744.   sequence.  If \vfill is not used, the text before the \break will be
  745.   spaced to fill the page.
  746.  
  747.   If you want TeX to be more flexible about its vertical page sizing,
  748.   place the \raggedbottom command in your document.  TeX will then
  749.   adjust the bottom margin of each page slightly to make vertical
  750.   spacing more consistent.
  751.  
  752.  
  753.   3.5.  Page numbers, headers, and footers.
  754.  
  755.   teTeX by default places the page number at the bottom center of the
  756.   page.  If you want to change the location and style of the page
  757.   number, you can specify alternate headers and footers by changing
  758.   definitions of \headline and \footline.  The default value for
  759.   \footline contains the \folio command, which prints the page number.
  760.   The default value for \headline is \hfil, so a blank line is printed.
  761.  
  762.   The \pageno command is a synonym for TeX's internal page counter.  You
  763.   can change the page number by changing the value of \pageno.  If
  764.   \pageno is negative, the numbers are printed as Roman numerals.
  765.  
  766.   \pageno=10
  767.   \pageno=-1
  768.  
  769.  
  770.  
  771.   The command \nopagenumbers is shorthand for:
  772.  
  773.   \headline={\hfil}
  774.   \footline={\hfil}
  775.  
  776.  
  777.  
  778.   The default footline also contains the font command \tenrm, which sets
  779.   the page number's font to 10-point Roman.  If you want to print the
  780.   page number in 12-point Roman, for example, you would first define a
  781.   12-point Roman font, and use that in the definition of \footline.
  782.   Font commands are discussed in Section ``Font commands''.
  783.  
  784.   \font\twelvrm=cmr12
  785.   \footline={\hss\twelvrm\folio\hss}
  786.  
  787.  
  788.  
  789.   You can put a rule, a horizontal line, at the top of each page by
  790.   redefining \headline as:
  791.  
  792.  
  793.   \headline={\hrulefill}
  794.  
  795.  
  796.  
  797.   To specify different headers for even and odd pages use the
  798.   \ifoddcommand, which has the form:
  799.  
  800.   \ifodd[condition][true-action]\else[false-action
  801.  
  802.  
  803.   An example \headline that uses different headers for even and odd
  804.   pages would be:
  805.  
  806.   \headline={\ifodd\pageno odd-page-header \else even-page-header}
  807.  
  808.  
  809.   The \ifodd statement uses the first argument if the page number is
  810.   odd, and the second argument otherwise.
  811.  
  812.  
  813.   3.6.  Titles and macros.
  814.  
  815.   TeX provides only the \beginsection macro for section headings.  It
  816.   leaves a space above its argument, prints the text of the heading in
  817.   bold type, adds a \smallskip after the text of the heading, and starts
  818.   the next paragraph with no indent.
  819.  
  820.   The LaTeX chapter and section commands described below add section
  821.   numbering, and will print the section names and numbers in the page
  822.   headings, and automatically add the sections to the Table of Contents.
  823.  
  824.   In plain TeX, you must write these functions yourself.  The \def
  825.   command allows you to define new commands.  Suppose you want to print
  826.   a chapter title.  First you define the font that you want to use.  A
  827.   large, sans serif font for chapter titles would be defined like this:
  828.  
  829.   \font\chapterfontsans=cmss12 scaled \magstep 4
  830.  
  831.  
  832.   You can use the \chapterfontsans command anywhere you want to switch
  833.   to this font, which is approximately 24 points in height.  However, in
  834.   this example, it will be used primarily in the command \chaptertitle¡
  835.   sans.  Here is its definition:
  836.  
  837.   \def\chaptertitlesans#1{\hbox{}\bigskip\bigskip
  838.     \noindent{\leftline{\chapterfontsans#1}}
  839.     \par\bigskip\bigskip\noindent}
  840.  
  841.  
  842.   The first line, \hbox{}\bigskip, anchors a 12-point space at the top
  843.   of the page by placing an empty \hbox{} there.  The line with the
  844.   chapter title is not indented, nor is the paragraph which immediately
  845.   follows it.  If you place a blank line between the \sschaptertitle
  846.   macro and the next paragraph, the final \noindent applies to the blank
  847.   line, not the text of the following paragraph.  To format correctly,
  848.   use the \sschaptertitle as in this example:
  849.  
  850.   The #1 statement in the definition is replaced by the first argument
  851.   to \chaptertitlesans; that is, the title of the chapter.  Parameters
  852.   TeX definitions are declared with #1, #2, #3, and so on.  An example
  853.   usage of \chaptertitlesans would be:
  854.  
  855.  
  856.  
  857.  
  858.  
  859.   \chaptertitlesans{Chapter 1}
  860.   This is the starting text of the first paragraph of the chapter.
  861.   The paragraph will not be indented.  The chapter's title is
  862.   "Chapter 1."
  863.  
  864.  
  865.  
  866.  
  867.   4.  LaTeX commands.
  868.  
  869.  
  870.   4.1.  Document structure.
  871.  
  872.   Documents formatted for LaTeX have a few more rules, but with complex
  873.   documents, LaTeX can greatly simplify the formatting process.
  874.  
  875.   Essentially, LaTeX is a document markup language which tries to
  876.   separate the output style from the document's logical content.  For
  877.   example, formatting a section heading with TeX would require
  878.   specifying 36 points of white space above the heading, then the
  879.   heading itself set in bold, 24-point type, then copying the heading
  880.   text and page number to the Table of Contents, then leaving 24 points
  881.   of white space after the heading.  By contrast, LaTeX has the
  882.   \section{} command, which does all of the work for you.  If you need
  883.   to change the format of the section headings throughout your document,
  884.   you can change the definition of \section{} instead of the text in the
  885.   document.  You can see where this would save hours of reformatting for
  886.   documents of more than a dozen pages in length.
  887.  
  888.   All LaTeX documents have three sections: a preamble, the body text,
  889.   and a postamble.  These terms are standard jargon and are widely used
  890.   by TeXperts.
  891.  
  892.   The preamble, at a minimum, specifies the type of document to be
  893.   produced---the document class---and a statement which signals the
  894.   beginning of the document's body text.  For example:
  895.  
  896.   \documentclass{article}
  897.   \begin{document}
  898.  
  899.  
  900.   The document's postamble is usually very simple.  Except in special¡
  901.   ized cases, it contains only the statement:
  902.  
  903.   \end{document}
  904.  
  905.  
  906.   Note the \begin{document} and \end{document} pairing.  In LaTeX, this
  907.   is called an environment.  All text must appear within an environment,
  908.   and many commands are effective only in the environments in which
  909.   they're called.  The document environment is the only instance where
  910.   LaTeX enforces this convention, however.  That is, it's the only envi¡
  911.   ronment that is required in a document.  (An exception is letter
  912.   class, which also requires you to declare \begin{letter} and
  913.   \end{letter}.  See the section ``Letters''.)  However, many formatting
  914.   features are specified as environments.  They're described in the fol¡
  915.   lowing sections.
  916.  
  917.   The document classes can be called with arguments.  For example,
  918.   instead of the default, 10-point type used as the base point size, as
  919.   in the previous example, we could have specified
  920.  
  921.   \documentclass[12pt]{article}
  922.  
  923.  
  924.  
  925.   to produce the document using 12 points as the base point size.  The
  926.   document class, article, makes the necessary adjustments.
  927.  
  928.   There are a few document classes which are commonly used.  They're
  929.   described below.  The report class is similar to article class, but
  930.   produces a title page and starts each section on a new page.  The
  931.   letter class includes special definitions for addresses, salutations,
  932.   and closings, a few of which are described below.
  933.  
  934.   You can include canned LaTeX code, commonly known as a package, with
  935.   the \usepackage{} command.
  936.  
  937.   \usepackage{fancyhdr}
  938.  
  939.  
  940.   The command above would include the LaTeX style file fancyhdr.sty from
  941.   one of the TEXINPUTS directories, which you and teTeX specified during
  942.   installation and setup processes.
  943.  
  944.  
  945.   \documentclass{article}
  946.   \usepackage{fancyhdr}
  947.   \begin{document}
  948.  
  949.  
  950.  
  951.   Note that the \usepackage{} declarations are given before the
  952.   \begin{document} statement; that is, in the document preamble.
  953.  
  954.   fancyhdr.sty extends the \pagestyle{} command so that you can create
  955.   custom headers and footers.  Most LaTeX document classes provide
  956.   headers and footers of the following standard page styles:
  957.  
  958.   \pagestyle{plain}       % default pages style -- page number centered at
  959.                           % the bottom of the page.
  960.   \pagestyle{empty}       % no headers or footers
  961.   \pagestyle{headings}    % print section number and page number at the
  962.                           % top of the page.
  963.   \pagestyle{myheadings}  % print custom information in the page heading.
  964.  
  965.  
  966.   Everything on a line to the right of the percent sign is a comment.
  967.  
  968.   The \pagestyle{} command doesn't take effect until the following page.
  969.   To change the headers and footers on the current page, use the command
  970.  
  971.   \thispagestyle{the_pagestyle}
  972.  
  973.  
  974.  
  975.   4.2.  Characters and type styles.
  976.  
  977.   Character styles are partially a function of the fonts specified in
  978.   the document.  However, bold and italic character emphasis should be
  979.   available for every font present on the system.  Underlining, too, can
  980.   be used, though its formatting presents special problems.  See section
  981.   ``LaTeX extension packages and other resources'', below.
  982.  
  983.   You can specify text to be emphasized in several ways.  The most
  984.   portable is the \em command.  All text within its scope is italicized
  985.   by default.  For example:
  986.  
  987.   This word will be {\em emphasized.}
  988.  
  989.  
  990.  
  991.   If you have italicized text that runs into text which is not itali¡
  992.   cized, you can specify an italic correction factor to be used.  The
  993.   command for this is \/; that is, a backslash and a forward slash.
  994.  
  995.   This example {\em will\/} print correctly.
  996.  
  997.   This example will {\em not} print correctly.
  998.  
  999.  
  1000.   Slightly less portable, but still acceptable in situations where
  1001.   they're used singly, are the commands \it, \bf, and \tt, which specify
  1002.   that the characters within their scope be printed using italic, bold,
  1003.   and monospaced (teletype) typefaces, respectively.
  1004.  
  1005.   {\tt This text will be printed monospaced,}
  1006.   {\it this text will be italic,} and
  1007.   {\bf this text will be bold\dots} all in one paragraph.
  1008.  
  1009.  
  1010.   The command \dots prints a series of three periods for ellipses, which
  1011.   will not break across a line.
  1012.  
  1013.   The most recent version of LaTeX, which is what you have, includes
  1014.   commands which account for instances where one emphasis command would
  1015.   supersede another.
  1016.  
  1017.   This is {\it not {\bf bold italic!}}
  1018.  
  1019.  
  1020.   What happens is that teTeX formats the text with the italic typeface
  1021.   until it encounters the \bf command, at which point it switches to
  1022.   boldface type.
  1023.  
  1024.   To get around this, the NFSS scheme of selecting font shapes requires
  1025.   three parameters for each typeface: shape, series, and family.  Not
  1026.   all font sets will include all of these styles.  LaTeX will print a
  1027.   warning, however, if it needs to substitute another font.
  1028.  
  1029.   You can specify the following font shapes:
  1030.  
  1031.   \textup{text}          % upright shape (the default)
  1032.   \textit{text}          % italic
  1033.   \textsl{text}          % slanted
  1034.   \textsc{text}          % small caps
  1035.  
  1036.  
  1037.   These are the two series that most fonts have:
  1038.  
  1039.   \textmd{text}          % medium series (the default)
  1040.   \textbf{text}          % boldface series.
  1041.  
  1042.  
  1043.   There are generally three families of type available.
  1044.  
  1045.   \textrm{text}          % Roman (the default)
  1046.   \textsf{text}          % sans serif
  1047.   \texttt{text}          % typewriter (monospaced, Courier-like)
  1048.  
  1049.  
  1050.   Setting font styles using these parameters, you can combine effects.
  1051.  
  1052.   \texttt{\textit{This example likely will result in a font
  1053.   substitution, because many fonts don't include a typewriter italic
  1054.   typeface.}}
  1055.  
  1056.  
  1057.   The font family defaults to Computer Modern, which is a bit-mapped
  1058.   font.  Other font families are usually Postscript-format Type 1 fonts.
  1059.   See section ``Using PostScript fonts'' for details on how to specify
  1060.   them.
  1061.  
  1062.   There are also many forms of accents and special characters which are
  1063.   available for typesetting.  This is only a few of them.  (Try
  1064.   typesetting these on your own printer.)
  1065.  
  1066.   \'{o}  \`{e}  \^{o}  \"{u}        \={o}  \c{c}  `? `!
  1067.   \copyright     \pounds                \dag
  1068.  
  1069.  
  1070.   Finally, there are characters which are used as meta- or escape char¡
  1071.   acters in TeX and LaTeX.  One of them, the dollar sign, is mentioned
  1072.   above.  The complete set of meta characters, which need to be escaped
  1073.   with a backslash to be used literally, is:
  1074.  
  1075.   # $ % & _ { }
  1076.  
  1077.  
  1078.  
  1079.   There are also different alphabets available, like Greek and Cyrillic.
  1080.   LaTeX provides many facilities for setting non-English text, which are
  1081.   covered by some of the other references mentioned here
  1082.  
  1083.  
  1084.   4.3.  Margins and line spacing.
  1085.  
  1086.  
  1087.   Changing margins in a TeX or LaTeX document is not a straightforward
  1088.   task.  A lot depends on the relative indent of the text you're trying
  1089.   to adjust the margin for.  The placement of the margin-changing
  1090.   command is also significant.
  1091.  
  1092.   For document-wide changes to LaTeX documents, the \evensidemargin and
  1093.   \oddsidemargin commands are available.  They affect the left-hand
  1094.   margins of the even-numbered and odd-numbered pages, respectively.
  1095.   For example,
  1096.  
  1097.   \evensidemargin=1in
  1098.   \oddsidemargin=1in
  1099.  
  1100.  
  1101.   adds on inch to the left-hand margin of the even and odd pages in
  1102.   addition to the standard one-inch, left-hand margin.  These commands
  1103.   affect the entire document and will shift the entire body of the text
  1104.   right and left across a page, regardless of any local indent, so
  1105.   they're safe to use with LaTeX environments like verse and list.
  1106.  
  1107.   Below is a set of margin-changing macros which I wrote.  They have a
  1108.   different effect than the commands mentioned above.  Because they use
  1109.   plain TeX commands, they're not guaranteed to honor the margins of any
  1110.   LaTeX environments which may be in effect, but you can place them
  1111.   anywhere in a document and change the margins from that point on.
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.   %%  margins.sty -- v. 0.1   by Robert Kiesling
  1124.   %%  Copies of this code may be freely distributed in verbatim form.
  1125.   %%
  1126.   %%  Some elementary plain TeX margin-changing commands. Lengths are
  1127.   %%  in inches:
  1128.   %%  \leftmargin{1}   %% sets the document's left margin in 1 inch.
  1129.   %%  \leftindent{1}   %% sets the following paragraphs' indent in
  1130.   %%                     1 inch.
  1131.   %%  \rightindent{1}  %% sets the following paragraphs' right margins
  1132.   %%                   %% in 1 inch.
  1133.   %%  \llength{3}      %% sets the following lines' lengths to 3 inches.
  1134.   %%
  1135.   \message{Margins macros...}
  1136.   \def\lmargin#1{\hoffset = #1 in}
  1137.   \def\lindent#1{\leftskip = #1 in}
  1138.   \def\rindent#1{\rightskip = #1 in}
  1139.   \def\llength#1{\hsize = #1 in}
  1140.   %%
  1141.   %% (End of margins macros.}
  1142.  
  1143.  
  1144.   Place this code in a file called margins.sty in your local $TEXINPUTS
  1145.   directory.  The commands are explained in the commented section of the
  1146.   file.  To include them in a document, use the command
  1147.  
  1148.   \usepackage{margins}
  1149.  
  1150.  
  1151.   in the document preamble.
  1152.  
  1153.   While we're on the subject, if you don't want the right margin to be
  1154.   justified, which is the default, you can tell LaTeX to use ragged
  1155.   right margins by giving the command:
  1156.  
  1157.   \raggedright
  1158.  
  1159.  
  1160.  
  1161.   Setting line spacing also has its complexities.
  1162.  
  1163.   The baselineskip measurement is the distance between lines of text.
  1164.   It is given as an absolute measurement.  For example,
  1165.  
  1166.   \baselineskip=24pt
  1167.  
  1168.  
  1169.   or even better:
  1170.  
  1171.   \setlength{\baselineskip}{24pt}
  1172.  
  1173.  
  1174.   The difference between the two forms is that setlength will respect
  1175.   any scoping rules that may be in effect when you use the command.
  1176.  
  1177.   The problem with using baselineskip is that it also affects the
  1178.   distance between section headings, footnotes, and the like.  You need
  1179.   to take care that baselineskip is correct for whatever text elements
  1180.   you're formatting.  There are, however, LaTeX macro packages, like
  1181.   setspace.sty, which will help you in these circumstances.  See section
  1182.   ``LaTeX extension packages and other resources''.
  1183.  
  1184.  
  1185.   4.4.  Document classes.
  1186.  
  1187.   LaTeX provides document classes which provide standardized formats for
  1188.   documents.  They provide environments to format lists, quotations,
  1189.   footnotes, and other text elements.  Commonly used document classes
  1190.   are covered in the following sections.
  1191.  
  1192.  
  1193.   4.4.1.  Articles and reports.
  1194.  
  1195.   As mentioned above, the article class and the report class are
  1196.   similar.  The main differences are that the report class creates a
  1197.   title page by default and begins each section on a new page.  Mostly,
  1198.   though, the two document classes are similar.
  1199.  
  1200.   To create titles, abstracts, and bylines in these document classes,
  1201.   you can type, for example,
  1202.  
  1203.   \title{The Breeding Habits of Cacti}
  1204.   \author{John Q. Public}
  1205.   \abstract{Description of how common desert cacti search
  1206.   for appropriate watering holes to perform their breeding
  1207.   rituals.}
  1208.  
  1209.  
  1210.   in the document preamble.  Then, the command
  1211.  
  1212.   \maketitle
  1213.  
  1214.  
  1215.   given at the start of the text, will generate either a title page in
  1216.   the report class, or the title and abstract at the top of the first
  1217.   page, in the article class.
  1218.  
  1219.   Sections can be defined with commands that include the following:
  1220.  
  1221.   \section
  1222.   \subsection
  1223.   \subsubsection
  1224.  
  1225.  
  1226.   These commands will produce the standard, numbered sections used in
  1227.   technical documents.  For unnumbered sections, use
  1228.  
  1229.   \section*
  1230.   \subsection*
  1231.   \subsubsection*
  1232.  
  1233.  
  1234.   and so on.
  1235.  
  1236.   LaTeX provides many environments for formatting displayed material.
  1237.   You can include quoted text with the quotation environment.
  1238.  
  1239.   \begin{quotation}
  1240.   Start of paragraph to be quoted...
  1241.  
  1242.   ... end of paragraph.
  1243.   \end{quotation}
  1244.  
  1245.  
  1246.   For shorter quotes, you can use the quote environment.
  1247.  
  1248.   To format verse, use the verse environment.
  1249.  
  1250.   \begin{verse}
  1251.   Because I could not stop for death\\
  1252.   He kindly stopped for me
  1253.   \end{verse}
  1254.  
  1255.   Notice that you must use the double backslashes to break lines in the
  1256.   correct places.  Otherwise, LaTeX fills the lines in a verse environ¡
  1257.   ment, just like any other environment.
  1258.  
  1259.   Lists come in several flavors.  To format a bulleted list, the list
  1260.   environment is used:
  1261.  
  1262.   \begin{list}
  1263.   \item
  1264.   This is the first item of the list.
  1265.   \item
  1266.   This is the second item of the list...
  1267.   \item
  1268.   ... and so on.
  1269.   \end{list}
  1270.  
  1271.  
  1272.  
  1273.   A numbered list uses the enumerate environment:
  1274.  
  1275.   \begin{enumerate}
  1276.   \item
  1277.   Item No. 1.
  1278.   \item
  1279.   Item No. 2.
  1280.   \item
  1281.   \dots
  1282.   \end{enumerate}
  1283.  
  1284.  
  1285.  
  1286.   A descriptive list uses the description environment.
  1287.  
  1288.   \begin{description}
  1289.   \item{Oven} Dirty, needs new burner.
  1290.   \item{Refrigerator}  Dirty.  Sorry.
  1291.   \item{Sink and drainboard}  Stained, drippy, cold water faucet.
  1292.   \end{description}
  1293.  
  1294.  
  1295.  
  1296.  
  1297.   4.4.2.  Letters.
  1298.  
  1299.   The letter class uses special definitions to format business letters.
  1300.  
  1301.   The letter environment takes one argument, the address of the letter's
  1302.   addressee.  The address command, which must appear in the document
  1303.   preamble, defines the return address.  The signature command defines
  1304.   the sender's name as it appears after the closing.
  1305.  
  1306.   The LaTeX source of a simple business letter might look like this.
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.   \documentclass[12pt]{letter}
  1322.   \signature{John Q. Public}
  1323.   \address{123 Main St.\\Los Angeles, CA.  96005\\Tel: 123/456-7890}
  1324.   \begin{document}
  1325.   \begin{letter}{ACME Brick Co.\\100 Ash St.\\San Diego, CA 96403}
  1326.   \opening{Dear Sir/Madam:}
  1327.  
  1328.   With regard to one of your bricks that I found on my living room
  1329.   carpet surrounded by shards of my broken front window...
  1330.  
  1331.   (Remainder of the body of the letter.)
  1332.  
  1333.   \closing{Sincerely,}
  1334.  
  1335.   \end{letter}
  1336.   \end{document}
  1337.  
  1338.  
  1339.   Note that the addresses include double backslashes, which specify
  1340.   where the line breaks should occur.
  1341.  
  1342.  
  1343.   5.  LaTeX extension packages and other resources.
  1344.  
  1345.   We mentioned above that using underlining as a form of text emphasis
  1346.   presents special problems.  Actually, TeX has no problem underlining
  1347.   text, because it is a convention of mathematical typesetting.  In
  1348.   LaTeX, you can underline words with the command:
  1349.  
  1350.   \underline{text to be underlined}
  1351.  
  1352.  
  1353.   The problem is that underlining will not break across lines, and, in
  1354.   some circumstances, underlining can be uneven.  However, there is a
  1355.   LaTeX macro package, ready-made, that makes underlining the default
  1356.   mode of text emphasis.  It's called ulem.sty, and is one of the many
  1357.   contributed LaTeX packages that are freely available via the Internet.
  1358.  
  1359.   To use ulem.sty, include the command:
  1360.  
  1361.   \usepackage{ulem}
  1362.  
  1363.  
  1364.   in the document preamble.
  1365.  
  1366.   The packages which are available for LaTeX include:
  1367.  
  1368.      ifthen
  1369.         Include conditional statements in your documents.
  1370.  
  1371.      initials
  1372.         Defines a font for initial dropped capitals.
  1373.  
  1374.      sanskrit
  1375.         Font and preprocessor for producing documents in Sanskrit.
  1376.  
  1377.      recipe
  1378.         A LaTeX2e class to typeset recipes.
  1379.  
  1380.      refman
  1381.         Variant report and article styles.
  1382.  
  1383.   To make the path given in the Catalogue into a fully-qualified URL,
  1384.   concatenate the path to the host name URL and top-level path of the
  1385.   CTAN archive you wish to contact.  For example, the top-level CTAN
  1386.   directory of the site ftp.tex.ac.uk is ctan/tex-archive.  The complete
  1387.   URL of the directory of the refman package would be:
  1388.  
  1389.   ftp://ftp.tex.ac.uk/ctan/tex-archive/   +
  1390.   macros/latex/contrib/supported/refman   =
  1391.  
  1392.   ftp://ftp.tex.ac.uk/ctan/tex-archive/macros/latex/contrib/supported/refman/
  1393.  
  1394.  
  1395.   Some packages have more than one file, so only the path to the pack¡
  1396.   age's directory is given.
  1397.  
  1398.   When you have the URL in hand, you can retrieve the package from one
  1399.   of the CTAN archive sites listed in section ``Appendix A''.  You can
  1400.   download a complete list of the archive's contents as the file
  1401.   FILES.byname, in the archive's top-level directory.  You can also
  1402.   search the archive on line for a keyword with the ftp command
  1403.  
  1404.   quote site index <keyword>
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.   6.  Mixing text and graphics with dvips .
  1411.  
  1412.   In general, this section applies to any TeX or LaTeX document which
  1413.   mixes text and graphics.  teTeX, like most other TeX distributions, is
  1414.   configured to request Computer Modern fonts by default.  When printing
  1415.   documents with Type 1 scalable fonts or graphics, font and graphics
  1416.   imaging is the job of dvips. dvips can use either Computer Modern bit
  1417.   mapped fonts or Type 1 scalable fonts, or any combination of the two.
  1418.   First, let's concentrate on printing and previewing some graphics.
  1419.  
  1420.   You will probably want to follow this procedure any time a LaTeX
  1421.   source document has the statement
  1422.  
  1423.  
  1424.   \includepackage{graphics}
  1425.  
  1426.  
  1427.   in the document preamble.  This statement tells LaTeX to include the
  1428.   text of the graphics.sty package in the source document.  There are
  1429.   other commands to perform graphics operations, and the statements in
  1430.   plain-TeX documents may not clue you in whether you need to use dvips.
  1431.   The difference will be apparent in the output, though, when the docu¡
  1432.   ment is printed with missing figures and other graphics.
  1433.  
  1434.   So, for now, we'll concentrate on printing documents which use the
  1435.   LaTeX graphics.sty package.  You might want to take a look at the
  1436.   original TeX input.  It isn't included in the teTeX distribution, but
  1437.   it is available at
  1438.  
  1439.   ~CTAN/macros/latex/packages/graphics/grfguide.tex.
  1440.  
  1441.  
  1442.   What the teTeX distribution does include is the .dvi output file, and
  1443.   it is already TeXed for you.  There is a reason for this, and it has
  1444.   to do with the necessity of including Type 1 fonts in the output in
  1445.   order for the document to print properly.  If you want to LaTeX
  1446.   grfguide.tex, see the next section.  For now, however, we'll work on
  1447.   getting usable output using dvips.
  1448.  
  1449.   The file grfguide.dvi is located in the directory
  1450.  
  1451.   texmf/doc/latex/graphics
  1452.  
  1453.   The first step in outputting grfguide.dvi is to translate it to
  1454.   Postscript.  The program dvips is used for this.  It does just exactly
  1455.   what its name implies.  There are many options available for invoking
  1456.   dvips, but the simplest (nearly) form is
  1457.  
  1458.   dvips -f -r <grfguide.dvi >grfguide.ps
  1459.  
  1460.  
  1461.   The -f command switch tells dvips to operate as a filter, reading from
  1462.   standard input and writing to standard output.  dvips output can be
  1463.   configured so its output defaults to lpr.
  1464.  
  1465.   If you can print Postscript directly to your printer via lpr, you can
  1466.   simply type
  1467.  
  1468.   dvips -r grfguide.dvi
  1469.  
  1470.  
  1471.   The -r option tells dvips to output the pages in reverse order so they
  1472.   stack correctly when they exit a printer.  Use it or not, as appropri¡
  1473.   ate for your output device.
  1474.  
  1475.   Depending on whether you still have the fonts that dvilj2 generated
  1476.   from the last document, dvips and metafont may or may not need to
  1477.   create new fonts needed by grfguide.dvi.  Eventually, though, dvips
  1478.   will output a list of the pages translated to Postscript, and you will
  1479.   have your Postscript output ready to be rendered on whatever output
  1480.   device you have available.
  1481.  
  1482.   If you're lucky (and rich), then you have a Postscript-capable printer
  1483.   already and will be able to print grfguide.ps directly.  You can
  1484.   either spool the output to the printer using lpr.  If for some reason
  1485.   your printer software doesn't work right with Postscript files, you
  1486.   can, in a pinch, simply dump the file to printer, with
  1487.  
  1488.   cat grfguide.ps >/dev/lp0
  1489.  
  1490.  
  1491.   or whichever port your printer is attached to, though this is not rec¡
  1492.   ommended for everyday use.
  1493.  
  1494.   If you want or need to invoke Ghostscript manually, this is the
  1495.   standard procedure for its operation.  The first thing you want to do
  1496.   is invoke Ghostscript to view its command line arguments, like this:
  1497.  
  1498.   gs -help | less
  1499.  
  1500.  
  1501.   You'll see a list of supported output devices and sundry other com¡
  1502.   mands.  Pick the output device which most nearly matches your printer.
  1503.   I generally produce black-and-white text and use the cdjmono driver,
  1504.   which drives a color Deskjet in monochrome (black and white) mode.
  1505.  
  1506.   The command line I would use is:
  1507.  
  1508.   gs -dNOPAUSE -sDEVICE=cdjmono -sOutputFile=/tmp/gs.out grfguide.ps -c quit
  1509.  
  1510.  
  1511.   This will produce my HP-compatible output in the /tmp directory.  It's
  1512.   a good idea to use a directory like /tmp, because gs can be particular
  1513.   about access permissions, and you can't (and shouldn't) always count
  1514.   on being logged in as root to perform these steps.  Now you can print
  1515.   the file:
  1516.  
  1517.   lpr /tmp/gs.out
  1518.  
  1519.   Obviously, this can all go into a shell script.  On my system, I have
  1520.   two simple scripts written, pv and pr, which simply outputs the
  1521.   Postscript file either to the display or the printer.  Screen preview¡
  1522.   ing is possible without X, but it's far from ideal.  So, it's defi¡
  1523.   nitely worth the effort to install XFree86 to view the output on the
  1524.   screen..
  1525.  
  1526.   The order of commands in a gs command line is significant, because
  1527.   some of the options tell Ghostscript to look for pieces of Postscript
  1528.   code from its library.
  1529.  
  1530.   The important thing to remember is that grfguide.dvi makes requests
  1531.   for both Computer Modern bit mapped and Type 1 scaled fonts.  If you
  1532.   can mix scalable and bit mapped fonts in a document, you're well on
  1533.   the way to becoming a TeXpert.
  1534.  
  1535.  
  1536.   6.1.  What if my printer isn't supported?
  1537.  
  1538.   The teTeX distribution comes with only a limited selection of DVI
  1539.   output drivers: dvips, drivers for Hewlett Packard LaserJets, and
  1540.   nothing else.  You have two options if you have a printer which isn't
  1541.   LaserJet-compatible: You can use dvips and Ghostscript, which I would
  1542.   recommend anyway, for reasons already mentioned, or you can
  1543.   investigate other dviware sources.
  1544.  
  1545.   A limited number of DVI drivers have been ported to Linux and are
  1546.   available as pre-built binaries.  They are located in the Linux
  1547.   archives at ftp://sunsite.unc.edu/pub/Linux/apps/tex/dvi/.
  1548.  
  1549.   The master dviware libraries are maintained at the University of Utah
  1550.   archives.  If you can't find a DVI driver there that supports your
  1551.   printer, chances are that it doesn't exist.  You can also write your
  1552.   own DVI driver using the templates available there.  The library's URL
  1553.   is ftp://ftp.math.utah.edu/pub/tex/dvi/.
  1554.  
  1555.  
  1556.   7.  Using Postscript fonts.
  1557.  
  1558.  
  1559.   It used to be that public domain, Type 1 fonts were much poorer
  1560.   quality than Computer Modern bit mapped fonts.  This situation has
  1561.   improved in the last several years, though, but matching the fonts is
  1562.   up to you.  Having several different font systems on one machine can
  1563.   seem redundant and an unnecessary waste of disk space.  And the
  1564.   Computer Modern fonts can seem, well, a little too formal to be
  1565.   suitable for everyday use.  It reminds me sometimes of bringing out
  1566.   the good China to feed the dog.  At least you don't need to spend a
  1567.   bundle on professional quality fonts any longer.
  1568.  
  1569.   One of the major improvements of LaTeX2e over its predecessor was the
  1570.   inclusion of the New Font Selection Scheme.  (It's now called PSNFSS.)
  1571.   Formerly, TeX authors would specify fonts with commands like
  1572.  
  1573.   \font=bodyroman = cmr10 scaled \magstep 1
  1574.  
  1575.  
  1576.  
  1577.   which provides precision but requires the skills of a type designer
  1578.   and mathematician to make good use of.  Also, it's not very portable.
  1579.   If another system didn't have the font cmr10 (this is TeX nomenclature
  1580.   for Computer Modern Roman, 10 point, with the default medium stroke
  1581.   weight), somebody would have to re-code the fonts specifications for
  1582.   the entire document.  PSNFSS, however, allows you specify fonts by
  1583.   family (Computer Modern, URW Nimbus, Helvetica, Utopia, and so forth),
  1584.   weight (light, medium, bold), orientation (upright or oblique), face
  1585.   (Roman, Italic), and base point size.  (See the section ``Characters
  1586.   and type styles'' for a description of the commands to specify
  1587.   typefaces.)  Many fonts are packaged as families.  For example, a
  1588.   Roman-type font may come packaged with a sans serif font, like
  1589.   Helvetica, and a monospaced font, like Courier.  You, as the author of
  1590.   a LaTeX document, can specify an entire font family with one command.
  1591.  
  1592.   There are, as I said, several high-quality font sets available in the
  1593.   public domain.  One of them is Adobe Utopia.  Another is Bitstream
  1594.   Charter.  Both are commercial quality fonts which have been donated to
  1595.   the public domain.
  1596.  
  1597.   These happen to be two of my favorites.  If you look around one of the
  1598.   CTAN sites, you will find these and other fonts archived there. There
  1599.   are enough fonts around that you'll be able to design documents the
  1600.   way you want them to look, and not just English text, either.  TeX was
  1601.   originally designed for mathematical typesetting, so there is a full
  1602.   range of mathematical fonts available, as well as Cyrillic, Greek,
  1603.   Kana, and other alphabets too numerous to mention.
  1604.  
  1605.   The important thing to look for is files which have either the .pfa or
  1606.   .pfb extension.  They indicate that these are the scalable fonts
  1607.   themselves, not simply the metrics files.  Type 1 fonts use .pfm
  1608.   metric files, as opposed to the .tfm metric files which bit mapped
  1609.   fonts use.  The two font sets I mentioned above are included in teTeX
  1610.   distributions, as well as separately.
  1611.  
  1612.   What I said above, concerning the ease of font selection under PSNFSS,
  1613.   is true in this instance.  If we want to use the Charter fonts in our
  1614.   document instead of Computer Modern bit mapped, all that is necessary
  1615.   is include the LaTeX statement
  1616.  
  1617.   \renewcommand{\familydefault}{bch}
  1618.  
  1619.  
  1620.   in the document preamble, where ``bch'' is the common designation for
  1621.   Bitstream Charter.  The Charter fonts reside in the directory
  1622.  
  1623.   /usr/lib/teTeX/texmf/fonts/type1/bitstrea/charter
  1624.  
  1625.  
  1626.  
  1627.   There you'll see the .pfb files of the Charter fonts: bchb8a.pfb for
  1628.   Charter Bold, bchr8a.pfb for Charter Roman, bchbi8a.pfb for Charter
  1629.   Bold Italic.  The ``8a'' in the font names indicates the character
  1630.   encoding.  At this point you shouldn't need to worry much about them,
  1631.   because the encodings mostly differ for 8-bit characters, which have
  1632.   numeric values above 128 decimal.  They mostly define accents and non-
  1633.   English characters.  The Type 1 font encodings generally work well for
  1634.   Western alphabets because they conform to the ISO 8859 standards for
  1635.   international character sets, so this is an added benefit of using
  1636.   them.
  1637.  
  1638.   To typeset a document which has Charter fonts selected, you would give
  1639.   the command
  1640.  
  1641.   pslatex document.tex
  1642.  
  1643.  
  1644.   pslatex is a variant of teTeX's standard latex command which defines
  1645.   the directories where the Type 1 fonts are, as well as some additional
  1646.   LaTeX code to load.  You'll see the notice screen for pslatex followed
  1647.   by the status output of the TeX job itself.  In a moment, you'll have
  1648.   a .dvi file which includes the Charter font requests.  You can then
  1649.   print the file with dvips, and gs if necessary.
  1650.  
  1651.   Installing a Type 1 font set is not difficult, as long as you follow a
  1652.   few basic steps.  You should unpack the fonts in a subdirectory of the
  1653.   /usr/lib/teTeX/texmf/fonts/type1 directory, where your other Type 1
  1654.   fonts are located, and then run texhash to let the directory search
  1655.   routines know that the fonts have been added.  Then you need to add
  1656.   the font descriptions to the file psfonts.map so dvips knows they're
  1657.   on the system.  The format of the psfonts.map file is covered in a
  1658.   couple different places in the references mentioned above.  Again,
  1659.   remember to run the texhash program to update the teTeX directory
  1660.   database.
  1661.  
  1662.   It is definitely an advantage to use the X Windows System with
  1663.   teTeX--- XFree86 under Linux---because it allows for superior document
  1664.   previewing.  It's not required, but in general, anything that allows
  1665.   for easier screen previewing is going to benefit your work, in terms
  1666.   of the quality of the output.  However, there is a tradeoff with speed
  1667.   of editing, which is much quicker on character-mode displays.
  1668.  
  1669.  
  1670.   8.  Appendix A: CTAN site list.
  1671.  
  1672.   This is the text of the file CTAN.sites, which is available in the
  1673.   top-level directory of each CTAN archive or mirror site.
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.   In order to reduce network load, it is recommended that you use the
  1718.   Comprehensive TeX Archive Network (CTAN) host which is located in the
  1719.   closest network proximity to your site.  Alternatively, you may wish to
  1720.   obtain a copy of the CTAN via CD-ROM (see help/CTAN.cdrom for details).
  1721.  
  1722.   Known mirrors of the CTAN reside on (alphabetically):
  1723.     cis.utovrm.it (Italia)                /TeX
  1724.     ctan.unsw.edu.au (NSW, Australia)     /tex-archive
  1725.     dongpo.math.ncu.edu.tw (Taiwan)       /tex-archive
  1726.     ftp.belnet.be (Belgium)               /packages/TeX
  1727.     ftp.ccu.edu.tw (Taiwan)               /pub/tex
  1728.     ftp.cdrom.com (West coast, USA)       /pub/tex/ctan
  1729.     ftp.comp.hkbu.edu.hk (Hong Kong)      /pub/TeX/CTAN
  1730.     ftp.cs.rmit.edu.au  (Australia)       /tex-archive
  1731.     ftp.cs.ruu.nl (The Netherlands)       /pub/tex-archive
  1732.     ftp.cstug.cz (The Czech Republic)     /pub/tex/CTAN
  1733.     ftp.duke.edu (North Carolina, USA)    /tex-archive
  1734.     ftp.funet.fi (Finland)                /pub/TeX/CTAN
  1735.     ftp.gwdg.de (Deutschland)             /pub/dante
  1736.     ftp.jussieu.fr (France)               /pub4/TeX/CTAN
  1737.     ftp.kreonet.re.kr (Korea)             /pub/CTAN
  1738.     ftp.loria.fr (France)                 /pub/unix/tex/ctan
  1739.     ftp.mpi-sb.mpg.de (Deutschland)       /pub/tex/mirror/ftp.dante.de
  1740.     ftp.nada.kth.se (Sweden)              /pub/tex/ctan-mirror
  1741.     ftp.oleane.net (France)               /pub/mirrors/CTAN/
  1742.     ftp.rediris.es (Espa\~na)             /mirror/tex-archive
  1743.     ftp.rge.com (New York, USA)           /pub/tex
  1744.     ftp.riken.go.jp (Japan)               /pub/tex-archive
  1745.     ftp.tu-chemnitz.de (Deutschland)      /pub/tex
  1746.     ftp.u-aizu.ac.jp (Japan)              /pub/tex/CTAN
  1747.     ftp.uni-augsburg.de (Deutschland)     /tex-archive
  1748.     ftp.uni-bielefeld.de (Deutschland)    /pub/tex
  1749.     ftp.unina.it (Italia)                 /pub/TeX
  1750.     ftp.uni-stuttgart.de (Deutschland)    /tex-archive (/pub/tex)
  1751.     ftp.univie.ac.at (\"Osterreich)       /packages/tex
  1752.     ftp.ut.ee (Estonia)                   /tex-archive
  1753.     ftpserver.nus.sg (Singapore)          /pub/zi/TeX
  1754.     src.doc.ic.ac.uk (England)            /packages/tex/uk-tex
  1755.     sunsite.auc.dk (Denmark)              /pub/tex/ctan
  1756.     sunsite.cnlab-switch.ch (Switzerland) /mirror/tex
  1757.     sunsite.icm.edu.pl (Poland)           /pub/CTAN
  1758.     sunsite.unc.edu (North Carolina, USA) /pub/packages/TeX
  1759.     wuarchive.wustl.edu (Missouri, USA)   /packages/TeX
  1760.  
  1761.   Known partial mirrors of the CTAN reside on (alphabetically):
  1762.     ftp.adfa.oz.au (Australia)            /pub/tex/ctan
  1763.     ftp.fcu.edu.tw (Taiwan)               /pub2/tex
  1764.     ftp.germany.eu.net (Deutschland)      /pub/packages/TeX
  1765.     ftp.gust.org.pl (Poland)              /pub/TeX
  1766.     ftp.jaist.ac.jp (Japan)               /pub/TeX/tex-archive
  1767.     ftp.uu.net (Virginia, USA)            /pub/text-processing/TeX
  1768.     nic.switch.ch (Switzerland)           /mirror/tex
  1769.     sunsite.dsi.unimi.it (Italia)         /pub/TeX
  1770.     sunsite.snu.ac.kr (Korea)             /shortcut/CTAN
  1771.  
  1772.   Please send updates to this list to <ctan@urz.uni-heidelberg.de>.
  1773.  
  1774.   The participating hosts in the Comprehensive TeX Archive Network are:
  1775.     ftp.dante.de  (Deutschland)
  1776.          -- anonymous ftp                 /tex-archive (/pub/tex /pub/archive)
  1777.          -- gopher on node gopher.dante.de
  1778.          -- e-mail via ftpmail@dante.de
  1779.          -- World Wide Web access on www.dante.de
  1780.          -- Administrator: <ftpmaint@dante.de>
  1781.  
  1782.     ftp.tex.ac.uk (England)
  1783.          -- anonymous ftp                 /tex-archive (/pub/tex /pub/archive)
  1784.          -- gopher on node gopher.tex.ac.uk
  1785.          -- NFS mountable from nfs.tex.ac.uk:/public/ctan/tex-archive
  1786.          -- World Wide Web access on www.tex.ac.uk
  1787.          -- Administrator: <ctan-uk@tex.ac.uk>
  1788.  
  1789.  
  1790.  
  1791.  
  1792.   9.  Appendix B: Installing the CTAN teTeX distribution.
  1793.  
  1794.   The generic, teTeX distribution isn't any harder to install than the
  1795.   Linux packages.  See section ``Generic CTAN distribution'', below.
  1796.  
  1797.   You should consider installing the generic teTeX distribution from the
  1798.   CTAN archives if:
  1799.  
  1800.   ╖  Your system isn't based on one of the standard Linux distributions.
  1801.  
  1802.   ╖  You don't have root privileges on your system.
  1803.  
  1804.   ╖  You want or need to have the very latest version of teTeX, or
  1805.      LaTeX.
  1806.  
  1807.   ╖  You don't have enough disk space available for a full installation.
  1808.  
  1809.   ╖  You want to install teTeX somewhere instead of the /usr file
  1810.      system.
  1811.  
  1812.   ╖  You would like to share your teTeX installation with other UNIX
  1813.      variants or platforms on a network.  In this case, you should
  1814.      strongly consider installing from the source distribution.  See
  1815.      section ``Installing the source distribution'', below.
  1816.  
  1817.   ╖  You want the latest versions of teTeX's public domain Type 1 fonts,
  1818.      which are significantly better than the fonts included in earlier
  1819.      releases.
  1820.  
  1821.   A complete installation of the binary distribution requires 40-50 Mb
  1822.   of disk space, and building the distribution from the source code
  1823.   takes about 75 Mb, so you should make sure that the disk space is
  1824.   available before you start.  You don't need to have the GCC compiler
  1825.   or the X Windows System installed (although X certainly helps because
  1826.   it is much easier to preview documents on-screen).  All you need is an
  1827.   editor that is capable of producing plain ASCII, text (see section 2).
  1828.   What could be simpler?
  1829.  
  1830.   You can retrieve the files from one of the CTAN archives listed in
  1831.   section ``Appendix A''.  In the examples below, the files were
  1832.   retrieved from the CTAN archive at ftp.tex.ac.uk.
  1833.  
  1834.  
  1835.   9.1.  Installing the binary distribution.
  1836.  
  1837.  
  1838.  
  1839.   9.1.1.  Minimal installation.
  1840.  
  1841.  
  1842.   First, FTP to ftp.tex.ac.uk and cd to the directory
  1843.  
  1844.   ctan/tex-archive/systems/unix/teTeX/distrib/
  1845.  
  1846.  
  1847.   Retrieve the files
  1848.  
  1849.   INSTALL.bin
  1850.   install.sh
  1851.  
  1852.  
  1853.   and place them in the top-level directory where you want to install
  1854.   teTeX, for example, /var/teTeX if you plan to install teTeX in the
  1855.   /var file system.
  1856.  
  1857.   Print out the INSTALL.bin file.  Keep this file handy, because it
  1858.   describes how to install a minimal teTeX installation.  The minimal
  1859.   installation requires only 10-15 MB of disk space, but it is
  1860.   recommended that you install the complete teTeX package if at all
  1861.   possible.  For a minimum installation, you'll need the files
  1862.  
  1863.   ctan/tex-archive/systems/unix/teTeX/distrib/base/latex-base.tar.gz
  1864.   ctan/tex-archive/systems/unix/teTeX/distrib/base/tetex-base.tar.gz
  1865.  
  1866.  
  1867.   You'll also need one of two archives which contain the executable
  1868.   teTeX programs.  Retrieve the archive file
  1869.  
  1870.   ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linux.tar.gz
  1871.  
  1872.  
  1873.   if your system uses the Linux ELF shared libraries, ld.so of at least
  1874.   version 1.73, and clibs of at least version 5.09.  If it doesn't,
  1875.   retrieve the archive
  1876.  
  1877.   ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linuxaout.tar.gz
  1878.  
  1879.  
  1880.   which is compiled for systems that use the older, a.out-format static
  1881.   libraries.
  1882.  
  1883.   Then, following the instructions in the file INSTALL.bin, execute the
  1884.   command
  1885.  
  1886.   sh ./install.sh
  1887.  
  1888.  
  1889.   while in the top-level teTeX installation directory. (Make sure that
  1890.   the teTeX archives are located there, too.)  After a few moments, the
  1891.   installation program will warn you that you are missing some of the
  1892.   teTeX packages.  However, if you're planning only a minimal teTeX
  1893.   installation, you should ignore the warnings and proceed.  To config¡
  1894.   ure the basic teTeX system, see section ``Base system configuration'',
  1895.   below.
  1896.  
  1897.   To install the remaining packages, see the next section.
  1898.  
  1899.  
  1900.   9.1.2.  Complete installation.
  1901.  
  1902.   To perform a complete teTeX installation, retrieve the archive files
  1903.   listed in the previous section, as well as the following files:
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/ams-doc.tar.gz
  1916.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/bibtex-doc.tar.gz
  1917.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/eplain-doc.tar.gz
  1918.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/fonts-doc.tar.gz
  1919.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/general-doc.tar.gz
  1920.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/generic-doc.tar.gz
  1921.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/latex-doc.tar.gz
  1922.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/makeindex-doc.tar.gz
  1923.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/metapost-doc.tar.gz
  1924.   ctan/tex-archive/systems/unix/teTeX/distrib/doc/programs-doc.tar.gz
  1925.   ctan/tex-archive/systems/unix/teTeX/distrib/fonts/ams-fonts.tar.gz
  1926.   ctan/tex-archive/systems/unix/teTeX/distrib/fonts/dc-fonts.tar.gz
  1927.   ctan/tex-archive/systems/unix/teTeX/distrib/fonts/ec-fonts.tar.gz
  1928.   ctan/tex-archive/systems/unix/teTeX/distrib/fonts/misc-fonts.tar.gz
  1929.   ctan/tex-archive/systems/unix/teTeX/distrib/fonts/postscript-fonts.tar.gz
  1930.   ctan/tex-archive/systems/unix/teTeX/distrib/fonts/sauter-fonts.tar.gz
  1931.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/amstex.tar.gz
  1932.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/bibtex.tar.gz
  1933.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/eplain.tar.gz
  1934.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/latex-extra.tar.gz
  1935.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/metapost.tar.gz
  1936.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/pictex.tar.gz
  1937.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/pstricks.tar.gz
  1938.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/texdraw.tar.gz
  1939.   ctan/tex-archive/systems/unix/teTeX/distrib/goodies/xypic.tar.gz
  1940.  
  1941.  
  1942.   All of these files should be placed in the top-level directory where
  1943.   you want teTeX to reside.  As with the minimal installation, execute
  1944.   the command
  1945.  
  1946.   sh ./install.sh
  1947.  
  1948.  
  1949.  
  1950.   9.2.  Base system configuration.
  1951.  
  1952.   The install.sh script, after determining which teTeX archive series
  1953.   are present, will present you with a menu of options.  The only
  1954.   setting you need to make at this point is to set the top-level
  1955.   directory where you want teTeX installed, by selecting the ``D''
  1956.   option.  You must, of course, choose a directory in whose parent
  1957.   directory you have write permissions.  For example, if you are
  1958.   installing teTeX in your home directory, you would specify the teTeX
  1959.   installation directory as
  1960.  
  1961.   /home/john.q.public/teTeX
  1962.  
  1963.  
  1964.   and, after returning to the main menu, select ``I'' to proceed with
  1965.   the installation.  Note that the directory must not exist already: the
  1966.   install.sh script must be able to create it.
  1967.  
  1968.   An option which you should consider enabling, is setting an
  1969.   alternative directory for generated fonts.  Even if you plan to use
  1970.   only Postscript-format, Type 1 scalable fonts, occasionally you'll
  1971.   process a file that requires the Computer Modern fonts.  Enabling this
  1972.   option requires that you enter the directory to use.  You must have
  1973.   write permissions for the parent directory.  Following the example
  1974.   above, you could specify
  1975.  
  1976.   /home/john.q.public/texfonts
  1977.  
  1978.  
  1979.   or, if you want the generated fonts to be accessible by all users on
  1980.   the system, specify a directory like
  1981.   /var/texfonts
  1982.  
  1983.  
  1984.   I would recommend that you not, however, use the default /var/tmp/tex¡
  1985.   fonts directory for this option, because the generated fonts could be
  1986.   deleted after the next reboot, and the fonts will need to be generated
  1987.   again the next time they're needed.
  1988.  
  1989.   After you've selected the option ``I'', and install.sh has installed
  1990.   the archives, set various permissions, and generated its links and
  1991.   format files, the program will exit with a message telling you to add
  1992.   the teTeX binary directory to your $PATH environment variable, and the
  1993.   directories where the man pages and info files reside to your $MANPATH
  1994.   and $INFOPATH environment variables.  For example, add the statements
  1995.  
  1996.   export PATH=$PATH:"/home/john.q.public/teTeX/bin"
  1997.   export MANPATH=$MANPATH":/home/john.q.public/teTeX/man"
  1998.   export INFOPATH$=INFOPATH":/home/john.q.public/teTeX/info"
  1999.  
  2000.  
  2001.   to your ~/.bash_profile if you use bash as your shell, or to your
  2002.   ~/.profile if you use another shell for logins.
  2003.  
  2004.   Log out, and then log in again, so the environment variables are
  2005.   registered.  Then, run the command
  2006.  
  2007.   texconfig confall
  2008.  
  2009.  
  2010.   to insure that the installation is correct.
  2011.  
  2012.   Next, you can configure teTeX for you specific hardware.  See section
  2013.   ``Post-installation configuration details'', below.
  2014.  
  2015.  
  2016.   9.3.  Installing the CTAN source distribution.
  2017.  
  2018.   To install teTeX V. 0.4 from the source code, ftp to a CTAN site like
  2019.   ftp://ftp.tex.ac.uk and retrieve the files
  2020.  
  2021.   ctan/tex-archive/systems/unix/teTeX/distrib/INSTALL.src
  2022.   ctan/tex-archive/systems/unix/teTeX/distrib/sources/README.texmf-src
  2023.   ctan/tex-archive/systems/unix/teTeX/distrib/sources/teTeX-lib-0.4pl8.tar.gz
  2024.   ctan/tex-archive/systems/unix/teTeX/distrib/sources/teTeX-src-0.4pl7.tar.gz
  2025.  
  2026.  
  2027.  
  2028.   Read over the instructions in INSTALL.src, then su to root and unpack
  2029.   the files in a directory for which you have read-write-execute
  2030.   permissions.
  2031.  
  2032.   Remember to use the p argument to tar, and also remember to unset the
  2033.   noclobber option of bash.  You can do this with the counterintuitive
  2034.   command
  2035.  
  2036.   set +o noclobber
  2037.  
  2038.  
  2039.   Note that the argument +o to set unsets a variable, just exactly back¡
  2040.   wards from what you might expect.
  2041.  
  2042.   The file teTeX-lib-0.4pl8.tar.gz will create the directory ./teTeX.
  2043.   The file teTeX-src-0.4pl7.tar.gz will create the directory teTeX-
  2044.   src-0.4 Print out the file INSTALL.src and keep it nearby for the
  2045.   following steps. cd to the ./teTeX-src-0.4 directory, and, per the
  2046.   instructions in the INSTALL.src file, edit ./Makefile.  You need to
  2047.   set the TETEXDIR variable to the absolute path of the parent teTeX
  2048.   directory.  This will be the subdirectory teTeX of the directory where
  2049.   you unpacked the source and library archives.  For example, if you
  2050.   unpacked the archives in your home directory, you would set TETEXDIR
  2051.   to
  2052.  
  2053.   /home/john.q.public/teTeX
  2054.  
  2055.  
  2056.   The rest of the Makefile options are pretty generic.  With GCC version
  2057.   2.7.2 and later, you should not need to make any further adjustments
  2058.   unless you have a non-standard compiler and library setup, or want the
  2059.   compiler to perform some further optimizations, or for some other rea¡
  2060.   son.  Check that the USE_DIALOG, USE_NCURSES, and HAVE_NCURSES vari¡
  2061.   ables are set correctly for your system, because the dialog program
  2062.   needs the ncurses library to be installed.  A ncurses library is
  2063.   included in the source distribution, so the default values in the
  2064.   Makefile should work fine.  If you can't get ncurses to compile or
  2065.   link, texconfig can also be run from the command line.
  2066.  
  2067.   If you've done everything correctly up to this point, you should be
  2068.   able to type make world in the top-level source directory, and relax
  2069.   until the teTeX executables are built.  This can take a few hours.
  2070.  
  2071.   After the build has completed, set the environment variables $PATH,
  2072.   $MANPATH, and $INFOPATH to include the teTeX directories.  The
  2073.   statements which would be added to the file ~/.bash_profile, in the
  2074.   example, above, would be
  2075.  
  2076.   export PATH=$PATH":/home/john.q.public/teTeX/bin/i386-linux"
  2077.   export MANPATH=$MANPATH":/home/john.q.public/teTeX/man"
  2078.   export INFOPATH=$INFOPATH":/home/john.q.public/teTeX/info"
  2079.  
  2080.  
  2081.   The $PATH variable is different in the source distribution than in the
  2082.   binary distribution.  Note that here the path to the binaries is
  2083.   teTeX/bin/i386-linux instead of simply teTeX/bin as in the binary dis¡
  2084.   tribution.
  2085.  
  2086.   At this point you can run texconfig confall to ensure that the paths
  2087.   have been set correctly, and then proceed to configure teTeX as in the
  2088.   binary distribution.  See the section ``Post-installation
  2089.   configuration details'', below.
  2090.  
  2091.  
  2092.   9.4.  Post-installation configuration details.
  2093.  
  2094.   The first thing you want to do is look at Thomas Esser's README file.
  2095.   It contains a lot of hints on how to configure teTeX for your output
  2096.   device (i.e., printer).  The README file is located in the directory
  2097.  
  2098.   /usr/lib/teTeX/texmf/doc/tetex
  2099.  
  2100.  
  2101.   Read the file over with the command (the path in the following exam¡
  2102.   ples is that of the Slackware distribution):
  2103.  
  2104.   less /usr/lib/teTeX/texmf/doc/tetex/README
  2105.  
  2106.  
  2107.   or, print it out with the command
  2108.  
  2109.   cat /usr/lib/teTeX/texmf/doc/tetex/README >/dev/lp0
  2110.  
  2111.  
  2112.  
  2113.   assuming that your printer is connected to /dev/lp0.  Substitute the
  2114.   device driver file that your printer is connected to, as appropriate.
  2115.  
  2116.   Or, better still, print it using the lpr command:
  2117.  
  2118.   lpr /usr/lib/teTeX/texmf/doc/tetex/README
  2119.  
  2120.  
  2121.   You should have installed the printer daemon that is included with
  2122.   your distribution of Linux.  If not, do that now, per the instructions
  2123.   that come with the package.
  2124.  
  2125.   Print out the teTeX-FAQ. Keep the FAQ handy because it contains useful
  2126.   hints for configuring teTeX's output drivers for your printer.  We'll
  2127.   get to that in a moment.  In more recent releases of teTeX, the teTeX-
  2128.   FAQ is viewable via the texconfig utility.
  2129.  
  2130.   Next, you want to define a directory to store your own TeX format
  2131.   files.  teTeX searches the directories listed by the $TEXINPUTS
  2132.   environment variable for local TeX input files:
  2133.  
  2134.   export TEXINPUTS=".:~/texinputs:"
  2135.  
  2136.  
  2137.   to the system-wide /etc/profile file.  Individual users can set their
  2138.   own local $TEXINPUTS directory, by adding the line in their ~/.profile
  2139.   or ~/.bash_profile if bash is the default shell.  The $TEXINPUTS envi¡
  2140.   ronment variable tells teTeX to look for users' individual TeX style
  2141.   files in the ~/texinputs directories under each user's home directory.
  2142.   It is critical that a colon appear before and after this directory.
  2143.   teTeX is going to append its own directory searches to your own.  You
  2144.   want to have teTeX search the local format files first, so it uses the
  2145.   local versions of any of the standard files you have edited.
  2146.  
  2147.   Add the /usr/lib/teTeX/bin directory to the system-wide path if you're
  2148.   installing teTeX as root.  Again, if you're installing a personal copy
  2149.   of teTeX, add the directory where the teTeX binaries are located to
  2150.   the front your $PATH with the following line in your ~/.profile or
  2151.   ~/.bash_profile:
  2152.  
  2153.   export PATH="~/tetex/bin:"$PATH
  2154.  
  2155.  
  2156.   Now, log in as root and run texconfig per the instructions in the
  2157.   teTeX-FAQ and choose the printer that is attached to your system.
  2158.   Make sure that you configure teTeX for both the correct printer and
  2159.   printer resolution.
  2160.  
  2161.   Finally, run the texhash program.  This ensures that teTeX's internal
  2162.   database is up to date.  The database is actually a ls-lR file.  You
  2163.   must run texhash every time you change the system configuration, or
  2164.   teTeX will not be able to locate your changes.
  2165.  
  2166.  
  2167.   10.  Appendix C: Distribution and Copyright.
  2168.  
  2169.  
  2170.   10.1.  Distribution.
  2171.  
  2172.   teTeX is free software; this means everyone is free to use the
  2173.   software and free to redistribute it on certain conditions.  The
  2174.   package is not in the public domain.  It is copyrighted and there are
  2175.   restrictions on its distribution, but these restrictions are designed
  2176.   to permit everything that a good cooperating citizen would want to do.
  2177.   What is not allowed is to try to prevent others from further sharing
  2178.   any version of free software that they might get from you.  The
  2179.   precise conditions are found in the GNU General Public License that
  2180.   comes with many of the software packages and also appears following
  2181.   this section.
  2182.  
  2183.   One way to get a copy of the package is from someone else who has it.
  2184.   You need not ask for our permission to do so, or tell any one else;
  2185.   just copy it.  If you have access to the Internet, you can get the
  2186.   latest distribution versions by anonymous FTP.  See the chapter
  2187.   ``Sources'' for more information.
  2188.  
  2189.   You may also receive the software when you buy a computer.  Computer
  2190.   manufacturers are free to distribute copies on the same terms that
  2191.   apply to everyone else.  These terms require them to give you the full
  2192.   sources, including whatever changes they may have made, and to permit
  2193.   you to redistribute these packages received from them under the usual
  2194.   terms of the General Public License.  In other words, the program must
  2195.   be free for you when you get it, not just free for the manufacturer.
  2196.  
  2197.   You can also order copies of GNU software from the Free Software
  2198.   Foundation on CD-ROM.  This is a convenient and reliable way to get a
  2199.   copy; it is also a good way to help fund our work.  (The Foundation
  2200.   has always received most of its funds in this way.)  An order form is
  2201.   included many distribution, and on our web site in
  2202.   http://www.gnu.ai.mit.edu/order/order.html.  For further information,
  2203.   write to
  2204.  
  2205.  
  2206.   Free Software Foundation
  2207.   59 Temple Place, Suite 330
  2208.   Boston, MA  02111-1307 USA
  2209.   USA
  2210.  
  2211.  
  2212.  
  2213.   The income from distribution fees goes to support the foundation's
  2214.   purpose: the development of new free software, and improvements to our
  2215.   existing programs.
  2216.  
  2217.   If you use GNU software at your workplace, please suggest that the
  2218.   company make a donation.  If company policy is unsympathetic to the
  2219.   idea of donating to charity, you might instead suggest ordering a CD-
  2220.   ROM from the Foundation occasionally, or subscribing to periodic
  2221.   updates.
  2222.  
  2223.  
  2224.   10.2.  GNU GENERAL PUBLIC LICENSE
  2225.  
  2226.  
  2227.   Version 2, June 1991
  2228.  
  2229.   Copyright (C) 1989, 1991 Free Software Foundation, Inc.  59 Temple
  2230.   Place, Suite 330, Boston, MA  02111-1307  USA
  2231.  
  2232.   Everyone is permitted to copy and distribute verbatim copies of this
  2233.   license document, but changing it is not allowed.
  2234.  
  2235.   Preamble.
  2236.  
  2237.   The licenses for most software are designed to take away your freedom
  2238.   to share and change it.  By contrast, the GNU General Public License
  2239.   is intended to guarantee your freedom to share and change free
  2240.   software---to make sure the software is free for all its users.  This
  2241.   General Public License applies to most of the Free Software
  2242.   Foundation's software and to any other program whose authors commit to
  2243.   using it.  (Some other Free Software Foundation software is covered by
  2244.   the GNU Library General Public License instead.)  You can apply it to
  2245.   your programs, too.
  2246.  
  2247.   When we speak of free software, we are referring to freedom, not
  2248.   price.  Our General Public Licenses are designed to make sure that you
  2249.   have the freedom to distribute copies of free software (and charge for
  2250.   this service if you wish), that you receive source code or can get it
  2251.   if you want it, that you can change the software or use pieces of it
  2252.   in new free programs; and that you know you can do these things.
  2253.  
  2254.   To protect your rights, we need to make restrictions that forbid
  2255.   anyone to deny you these rights or to ask you to surrender the rights.
  2256.   These restrictions translate to certain responsibilities for you if
  2257.   you distribute copies of the software, or if you modify it.
  2258.  
  2259.   For example, if you distribute copies of such a program, whether
  2260.   gratis or for a fee, you must give the recipients all the rights that
  2261.   you have.  You must make sure that they, too, receive or can get the
  2262.   source code.  And you must show them these terms so they know their
  2263.   rights.
  2264.  
  2265.   We protect your rights with two steps: (1) copyright the software, and
  2266.   (2) offer you this license which gives you legal permission to copy,
  2267.   distribute and/or modify the software.
  2268.  
  2269.   Also, for each author's protection and ours, we want to make certain
  2270.   that everyone understands that there is no warranty for this free
  2271.   software.  If the software is modified by someone else and passed on,
  2272.   we want its recipients to know that what they have is not the
  2273.   original, so that any problems introduced by others will not reflect
  2274.   on the original authors' reputations.
  2275.  
  2276.   Finally, any free program is threatened constantly by software
  2277.   patents.  We wish to avoid the danger that redistributors of a free
  2278.   program will individually obtain patent licenses, in effect making the
  2279.   program proprietary.  To prevent this, we have made it clear that any
  2280.   patent must be licensed for everyone's free use or not licensed at
  2281.   all.
  2282.  
  2283.   The precise terms and conditions for copying, distribution and
  2284.   modification follow.
  2285.  
  2286.   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  2287.  
  2288.  
  2289.   ╖  This License applies to any program or other work which contains a
  2290.      notice placed by the copyright holder saying it may be distributed
  2291.      under the terms of this General Public License.  The ``Program''
  2292.      below, refers to any such program or work, and a ``work based on
  2293.      the Program'' means either the Program or any derivative work under
  2294.      copyright law: that is to say, a work containing the Program or a
  2295.      portion of it, either verbatim or with modifications and/or
  2296.      translated into another language.  (Hereinafter, translation is
  2297.      included without limitation in the term,``modification.'')  Each
  2298.      licensee is addressed as ``you.''
  2299.  
  2300.      Activities other than copying, distribution and modification are
  2301.      not covered by this License; they are outside its scope.  The act
  2302.      of running the Program is not restricted, and the output from the
  2303.      Program is covered only if its contents constitute a work based on
  2304.      the Program (independent of having been made by running the
  2305.      Program).  Whether that is true depends on what the Program does.
  2306.  
  2307.   ╖  You may copy and distribute verbatim copies of the Program's source
  2308.      code as you receive it, in any medium, provided that you
  2309.      conspicuously and appropriately publish on each copy an appropriate
  2310.      copyright notice and disclaimer of warranty; keep intact all the
  2311.      notices that refer to this License and to the absence of any
  2312.      warranty; and give any other recipients of the Program a copy of
  2313.      this License along with the Program.
  2314.  
  2315.      You may charge a fee for the physical act of transferring a copy,
  2316.      and you may at your option offer warranty protection in exchange
  2317.      for a fee.
  2318.  
  2319.   ╖  You may modify your copy or copies of the Program or any portion of
  2320.      it, thus forming a work based on the Program, and copy and
  2321.      distribute such modifications or work under the terms of Section 1
  2322.      above, provided that you also meet all of these conditions:
  2323.  
  2324.      1. You must cause the modified files to carry prominent notices
  2325.      stating that you changed the files and the date of any change.
  2326.  
  2327.      2. You must cause any work that you distribute or publish, that in
  2328.      whole or in part contains or is derived from the Program or any
  2329.      part thereof, to be licensed as a whole at no charge to all third
  2330.      parties under the terms of this License.
  2331.  
  2332.      3. If the modified program normally reads commands interactively
  2333.      when run, you must cause it, when started running for such
  2334.      interactive use in the most ordinary way, to print or display an
  2335.      announcement including an appropriate copyright notice and a notice
  2336.      that there is no warranty (or else, saying that you provide a
  2337.      warranty) and that users may redistribute the program under these
  2338.      conditions, and telling the user how to view a copy of this
  2339.      License.  (Exception: if the Program itself is interactive but does
  2340.      not normally print such an announcement, your work based on the
  2341.      Program is not required to print an announcement.)
  2342.  
  2343.      These requirements apply to the modified work as a whole.  If
  2344.      identifiable sections of that work are not derived from the
  2345.      Program, and can be reasonably considered independent and separate
  2346.      works in themselves, then this License, and its terms, do not apply
  2347.      to those sections when you distribute them as separate works.  But
  2348.      when you distribute the same sections as part of a whole which is a
  2349.      work based on the Program, the distribution of the whole must be on
  2350.      the terms of this License, whose permissions for other licensees
  2351.      extend to the entire whole, and thus to each and every part
  2352.      regardless of who wrote it.
  2353.  
  2354.      Thus, it is not the intent of this section to claim rights or
  2355.      contest your rights to work written entirely by you; rather, the
  2356.      intent is to exercise the right to control the distribution of
  2357.      derivative or collective works based on the Program.
  2358.  
  2359.      In addition, mere aggregation of another work not based on the
  2360.      Program with the Program (or with a work based on the Program) on a
  2361.      volume of a storage or distribution medium does not bring the other
  2362.      work under the scope of this License.
  2363.  
  2364.   ╖  You may copy and distribute the Program (or a work based on it,
  2365.      under Section 2) in object code or executable form under the terms
  2366.      of Sections 1 and 2 above provided that you also do one of the
  2367.      following:
  2368.  
  2369.      1. Accompany it with the complete corresponding machine-readable
  2370.      source code, which must be distributed under the terms of Sections
  2371.      1 and 2 above on a medium customarily used for software
  2372.      interchange; or,
  2373.  
  2374.      2. Accompany it with a written offer, valid for at least three
  2375.      years, to give any third party, for a charge no more than your cost
  2376.      of physically performing source distribution, a complete machine-
  2377.      readable copy of the corresponding source code, to be distributed
  2378.      under the terms of Sections 1 and 2 above on a medium customarily
  2379.      used for software interchange; or,
  2380.  
  2381.      3. Accompany it with the information you received as to the offer
  2382.      to distribute corresponding source code.  (This alternative is
  2383.      allowed only for noncommercial distribution and only if you
  2384.      received the program in object code or executable form with such an
  2385.      offer, in accord with Subsection b above.)
  2386.  
  2387.      The source code for a work means the preferred form of the work for
  2388.      making modifications to it.  For an executable work, complete
  2389.      source code means all the source code for all modules it contains,
  2390.      plus any associated interface definition files, plus the scripts
  2391.      used to control compilation and installation of the executable.
  2392.      However, as a special exception, the source code distributed need
  2393.      not include anything that is normally distributed (in either source
  2394.      or binary form) with the major components (compiler, kernel, and so
  2395.      on) of the operating system on which the executable runs, unless
  2396.      that component itself accompanies the executable.
  2397.  
  2398.      If distribution of executable or object code is made by offering
  2399.      access to copy from a designated place, then offering equivalent
  2400.      access to copy the source code from the same place counts as
  2401.      distribution of the source code, even though third parties are not
  2402.      compelled to copy the source along with the object code.
  2403.  
  2404.   ╖  You may not copy, modify, sublicense, or distribute the Program
  2405.      except as expressly provided under this License.  Any attempt
  2406.      otherwise to copy, modify, sublicense or distribute the Program is
  2407.      void, and will automatically terminate your rights under this
  2408.      License.  However, parties who have received copies, or rights,
  2409.      from you under this License will not have their licenses terminated
  2410.      so long as such parties remain in full compliance.
  2411.  
  2412.   ╖  You are not required to accept this License, since you have not
  2413.      signed it.  However, nothing else grants you permission to modify
  2414.      or distribute the Program or its derivative works.  These actions
  2415.      are prohibited by law if you do not accept this License.
  2416.      Therefore, by modifying or distributing the Program (or any work
  2417.      based on the Program), you indicate your acceptance of this License
  2418.      to do so, and all its terms and conditions for copying,
  2419.      distributing or modifying the Program or works based on it.
  2420.  
  2421.   ╖  Each time you redistribute the Program (or any work based on the
  2422.      Program), the recipient automatically receives a license from the
  2423.      original licensor to copy, distribute or modify the Program subject
  2424.      to these terms and conditions.  You may not impose any further
  2425.      restrictions on the recipients' exercise of the rights granted
  2426.      herein.  You are not responsible for enforcing compliance by third
  2427.      parties to this License.
  2428.  
  2429.   ╖  If, as a consequence of a court judgment or allegation of patent
  2430.      infringement or for any other reason (not limited to patent
  2431.      issues), conditions are imposed on you (whether by court order,
  2432.      agreement or otherwise) that contradict the conditions of this
  2433.      License, they do not excuse you from the conditions of this
  2434.      License.  If you cannot distribute so as to satisfy simultaneously
  2435.      your obligations under this License and any other pertinent
  2436.      obligations, then as a consequence you may not distribute the
  2437.      Program at all.  For example, if a patent license would not permit
  2438.      royalty-free redistribution of the Program by all those who receive
  2439.      copies directly or indirectly through you, then the only way you
  2440.      could satisfy both it and this License would be to refrain entirely
  2441.      from distribution of the Program.
  2442.  
  2443.      If any portion of this section is held invalid or unenforceable
  2444.      under any particular circumstance, the balance of the section is
  2445.      intended to apply and the section as a whole is intended to apply
  2446.      in other circumstances.
  2447.  
  2448.      It is not the purpose of this section to induce you to infringe any
  2449.      patents or other property right claims or to contest validity of
  2450.      any such claims; this section has the sole purpose of protecting
  2451.      the integrity of the free software distribution system, which is
  2452.      implemented by public license practices.  Many people have made
  2453.      generous contributions to the wide range of software distributed
  2454.      through that system in reliance on consistent application of that
  2455.      system; it is up to the author/donor to decide if he or she is
  2456.      willing to distribute software through any other system and a
  2457.      licensee cannot impose that choice.
  2458.  
  2459.      This section is intended to make thoroughly clear what is believed
  2460.      to be a consequence of the rest of this License.
  2461.  
  2462.   ╖  If the distribution and/or use of the Program is restricted in
  2463.      certain countries either by patents or by copyrighted interfaces,
  2464.      the original copyright holder who places the Program under this
  2465.      License may add an explicit geographical distribution limitation
  2466.      excluding those countries, so that distribution is permitted only
  2467.      in or among countries not thus excluded.  In such case, this
  2468.      License incorporates the limitation as if written in the body of
  2469.      this License.
  2470.  
  2471.   ╖  The Free Software Foundation may publish revised and/or new
  2472.      versions of the General Public License from time to time.  Such new
  2473.      versions will be similar in spirit to the present version, but may
  2474.      differ in detail to address new problems or concerns.
  2475.  
  2476.      Each version is given a distinguishing version number.  If the
  2477.      Program specifies a version number of this License which applies to
  2478.      it and ``any later version,'' you have the option of following the
  2479.      terms and conditions either of that version or of any later version
  2480.      published by the Free Software Foundation.  If the Program does not
  2481.      specify a version number of this License, you may choose any
  2482.      version ever published by the Free Software Foundation.
  2483.  
  2484.   ╖  If you wish to incorporate parts of the Program into other free
  2485.      programs whose distribution conditions are different, write to the
  2486.      author to ask for permission.  For software which is copyrighted by
  2487.      the Free Software Foundation, write to the Free Software
  2488.      Foundation; we sometimes make exceptions for this.  Our decision
  2489.      will be guided by the two goals of preserving the free status of
  2490.      all derivatives of our free software and of promoting the sharing
  2491.      and reuse of software generally.
  2492.  
  2493.      NO WARRANTY
  2494.  
  2495.   ╖  BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
  2496.      WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  2497.      LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS
  2498.      AND/OR OTHER PARTIES PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY
  2499.      OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  2500.      LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  2501.      FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND
  2502.      PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE PROGRAM PROVE
  2503.      DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR
  2504.      OR CORRECTION.
  2505.  
  2506.   ╖  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  2507.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  2508.      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
  2509.      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  2510.      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  2511.      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
  2512.      DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
  2513.      OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  2514.      OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
  2515.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  2516.  
  2517.   END OF TERMS AND CONDITIONS
  2518.  
  2519.  
  2520.   10.3.  How to Apply These Terms to Your New Programs
  2521.  
  2522.   If you develop a new program, and you want it to be of the greatest
  2523.   possible use to the public, the best way to achieve this is to make it
  2524.   free software which everyone can redistribute and change under these
  2525.   terms.
  2526.  
  2527.   To do so, attach the following notices to the program.  It is safest
  2528.   to attach them to the start of each source file to most effectively
  2529.   convey the exclusion of warranty; and each file should have at least
  2530.   the ``copyright'' line and a pointer to where the full notice is
  2531.   found.
  2532.  
  2533.  
  2534.   [one line to give the program's name and an idea of what it does.
  2535.   Copyright (C) 19[yy]  [name of author]
  2536.  
  2537.   This program is free software; you can redistribute it and/or
  2538.   modify it under the terms of the GNU General Public License
  2539.   as published by the Free Software Foundation; either version 2
  2540.   of the License, or (at your option) any later version.
  2541.  
  2542.   This program is distributed in the hope that it will be useful,
  2543.   but WITHOUT ANY WARRANTY; without even the implied warranty of
  2544.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  2545.   GNU General Public License for more details.
  2546.  
  2547.   You should have received a copy of the GNU General Public License along
  2548.   with this program; if not, write to the Free Software Foundation, Inc.,
  2549.   59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
  2550.  
  2551.  
  2552.  
  2553.   Also add information on how to contact you by electronic and paper
  2554.   mail.
  2555.  
  2556.   If the program is interactive, make it output a short notice like this
  2557.   when it starts in an interactive mode:
  2558.  
  2559.  
  2560.   Gnomovision version 69, Copyright (C) 19[yy] [name of author]
  2561.   Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
  2562.   type `show w'.  This is free software, and you are welcome
  2563.   to redistribute it under certain conditions; type `show c'
  2564.   for details.
  2565.  
  2566.  
  2567.  
  2568.   The hypothetical commands ``show w'' and ``show c'' should show the
  2569.   appropriate parts of the General Public License.  Of course, the
  2570.   commands you use may be called something other than ``show w'' and
  2571.   ``show c''; they could even be mouse-clicks or menu items---whatever
  2572.   suits your program.
  2573.  
  2574.  
  2575.   You should also get your employer (if you work as a programmer) or
  2576.   your school, if any, to sign a ``copyright disclaimer'' for the
  2577.   program, if necessary.  Here is a sample; alter the names:
  2578.  
  2579.  
  2580.   Yoyodyne, Inc., hereby disclaims all copyright
  2581.   interest in the program `Gnomovision'
  2582.   (which makes passes at compilers) written
  2583.   by James Hacker.
  2584.  
  2585.   [signature of Ty Coon] 1 April 1989
  2586.   Ty Coon, President of Vice
  2587.  
  2588.  
  2589.  
  2590.   This General Public License does not permit incorporating your program
  2591.   into proprietary programs.  If your program is a subroutine library,
  2592.   you may consider it more useful to permit linking proprietary
  2593.   applications with the library.  If this is what you want to do, use
  2594.   the GNU Library General Public License instead of this License.
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.