bring docs up to date wrt sources

git-svn-id: svn://tug.org/texlive/trunk@2770 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 104 insertions, 293 deletions

diff --git a/Master/texmf/doc/tetex/teTeX-FAQ b/Master/texmf/doc/tetex/teTeX-FAQ
index f7072f1eb09..025a668de92 100644
--- a/Master/texmf/doc/tetex/teTeX-FAQ
+++ b/Master/texmf/doc/tetex/teTeX-FAQ
@@ -7,75 +7,49 @@ a line. My Email address:
 
 
 This article includes answers to:
-  0) Where can I get the teTeX distribution?
-  1) Is there a mailing list for teTeX?
-  2) Now that I know that there is a mailing list: is there an archive
-     of the list?
-  3) I use PostScript fonts in my documents. When previewing with xdvi,
-     mktexpk sometimes hangs in gsftopk.
-  4) I moved the binaries to a different location. Now, tex says:
-     ``I can't find the default format file!''.
-  5) I did not move the binaries, but I get the error:
-     ``I can't find the default format file!''.
-  6) I added some files in the texmf tree. But they are not found.
-  7) When running some old dvi files through a dvi driver, I get warnings
-     about checksum errors.
-  8) What is the best method to get pk fonts in a batch job?
-  9) What to do if I need the fonts for several modes?
- 10) Can I share the teTeX directory tree between different platforms?
- 11) After mktexpk and mktextfm successfully generate fonts, kpathsea
-     complains and does not use the newly generated font.
- 12) mktextfm runs Metafont with a mode that I do not like.
- 13) Is there an easy way to copy .tfm or .pk fonts from a temporal directory
-     to their standard directory below $TEXMFMAIN?
- 14) How about adding program XYY or a macro package ABC to teTeX?
- 15) I want to keep my files separate from the system's files. What do
-     I need to do to make sure that tex+friends will find my files?
- 16) How do I deinstall an old version of teTeX?
- 17) How do I manage to execute the right binaries on each platform?
- 18) Why does not install.sh call fontimport to copy the fonts from my
-     previous teTeX installation?
- 19) Under DOS, I used emTeX with LJ fonts. Which metafont mode should I use
-     now with teTeX?
- 20) Using the Shrink* Buttons in xdvi, I cannot get back to see the full
-     page on the screen.
- 21) Which is the right way of using the AMS fonts/macros with LaTeX?
- 22) teTeX doesn't work with my NEXTSTEP TeXview.app, what should I do ?
- 23) Some things do not work properly. What should I do now?
- 24) initex cannot include all the hyphenation patterns I need. It complains
-     with "! TeX capacity exceeded, sorry [pattern memory=NNNNN]."
- 25) The scrollbars of xdvi do not make sense to me. How do I move backwards?
- 26) Is teTeX freely redistributable?
- 27) dvips, pdftex, dvipdfm and xdvi use the European A4 size as default 
-     papersize. How do I change this to make letterpaper the default?
- 28) Why does ghostview display of my texts look so much worse than
-     with xdvi?
- 29) Metafont does not support the X display.
- 30) I have problems to use the LaTeX 209 llncs styles from Springer.
- 31) What about revtex or llncs styles? I don't get the pre-LaTeX 2e version
-     working with teTeX.
- 32) How can I get the Euro currency symbol?
+   0)  Where can I get the teTeX distribution?
+   1)  Is there a mailing list for teTeX?
+   2)  Now that I know that there is a mailing list: is there an archive
+   6)  I added some files in the texmf tree. But they are not found.
+   7)  When running some old dvi files through a dvi driver, I get warnings
+   8)  What is the best method to get pk fonts in a batch job?
+   9)  What to do if I need the fonts for several modes?
+  10)  Can I share the teTeX directory tree between different platforms?
+  11) After mktexpk and mktextfm successfully generate fonts, kpathsea
+  12) mktextfm runs Metafont with a mode that I do not like.
+  14) How about adding program XYY or a macro package ABC to teTeX?
+  15) I want to keep my files separate from the system's files. What do
+      I need to do to make sure that tex+friends will find my files?
+  16) How do I deinstall an old version of teTeX?
+  17) How do I manage to execute the right binaries on each platform?
+  20) Using the Shrink* Buttons in xdvi, I cannot get back to see the full
+  21) Which is the right way of using the AMS fonts/macros with LaTeX?
+  23) Some things do not work properly. What should I do now?
+  24) I get a error message about "TeX capacity exceeded". What can I do?
+  25) The scrollbars of xdvi do not make sense to me. How do I move backwards?
+  26) Is teTeX freely redistributable?
+  27) dvips, pdftex, dvipdfm and xdvi use the European A4 size as default
+  28) Why does ghostview display of my texts look so much worse than
+  29) Metafont does not support the X display.
+  32) How can I get the Euro currency symbol?
+  33) Font map files and enc files from my local texmf tree are not
+      found by dvips / pdftex etc.
+  34) texconfig, updmap and fmtutil just change my personal settings. How
+      can I change global defaults in a multi-user setup?
 
 Answers:
 
 0)  Where can I get the teTeX distribution?
 
-    The primary site is in germany:
-      ftp://sunsite.informatik.rwth-aachen.de:/pub/comp/tex/teTeX
-
-    Mirror sites:
-      ftp://ftp.dante.de/tex-archive/systems/unix/teTeX
-      ftp://ftp.tex.ac.uk/tex-archive/systems/unix/teTeX
-      ftp://lh116.uwinnipeg.ca/pub/teTeX/
-      ftp://ftp.duke.edu/tex-archive/systems/unix/teTeX
+    teTeX can be downloaded from CTAN and CTAN mirrors, e.g.:
+      ftp://ftp.dante.de/tex-archive/systems/unix/teTeX/
+      ftp://ftp.tex.ac.uk/tex-archive/systems/unix/teTeX/
+      ftp://ftp.duke.edu/tex-archive/systems/unix/teTeX/
       ftp://sunsite.auc.dk/pub/tex/ctan/systems/unix/teTeX/
 
-    The following form provides a good help for downloading teTeX:
-      http://theory.uwinnipeg.ca/search/tetex.html
-
 1)  Is there a mailing list for teTeX?
 
-    Yes. Tere is one list for discussion and one (moderated) list for
+    Yes. There is one list for discussion and one (moderated) list for
     announcements. The discussion list is
       tetex@dbs.uni-hannover.de
     and the announcement list is
@@ -98,83 +72,15 @@ Answers:
         get tetex archive
     to majordomo@dbs.uni-hannover.de .
 
-3)  I use PostScript fonts in my documents. When previewing with xdvi,
-    mktexpk sometimes hangs in gsftopk.
-
-    There are known problems with early versions of gs3.XXX when using
-    gsftopk. Solution: upgrade to gs3.33 or newer.
-
-4)  I moved the binaries to a different location. Now, tex says:
-    ``I can't find the default format file!''
-
-    The modified Kpathsea library (a library to locate files on disks,
-    written by Karl Berry) used in the teTeX distribution set the
-    variables SELFAUTODIR and SELFAUTOPARENT relative to the location of
-    the binary.
- 
-    SELFAUTODIR is the directory one level above the directory containing the
-    binary and SELFAUTOPARENT is its parent directory.
- 
-    Example1: assuming xdvi is found in /usr/tex/bin/i486-linux/xdvi.
-          => SELFAUTODIR:         /usr/tex/bin
-          => SELFAUTOPARENT:      /usr/tex
- 
-    Example2: assuming xdvi is found in /usr/tex/bin/xdvi.
-          => SELFAUTODIR:         /usr/tex
-          => SELFAUTOPARENT:      /usr
- 
-    The file texmf.cnf is searched for in $SELFAUTODIR, $SELFAUTOPARENT,
-    $TETEXDIR. If the file texmf.cnf is not found, set the TETEXDIR variable
-    in your environment.
- 
-    But even if the texmf.cnf file is found, there may be an incorrect
-    definition of TETEXDIR in the file. Check the following:
-
-    In example1, you could use TETEXDIR=$SELFAUTOPARENT and in example2
-    TETEXDIR=$SELFAUTODIR. A simpler setting for TETEXDIR could simply
-    be TETEXDIR=/usr/tex in both cases. This can be convenient if you
-    are not going to change the location of your teTeX tree.
-
-5)  I did not move the binaries, but I get the error:
-    ``I can't find the default format file!''.
-
-    The name of the default format file is <program>.fmt, where
-    <program> is the name of the binary you call (e.g. latex, tex).
-    The directory where the format files are stored is $TEXMF/web2c.
-    You can see the full search path using the command
-	kpsetool -p fmt
-
-    You should first look into these directories if the format file
-    is there or not. If it is there, enter the following commands
-    (use the name of the format file that is not found instead of
-    my example "latex.fmt"):
-	texconfig confall
-	env KPATHSEA_DEBUG=-1 kpsetool -w fmt latex.fmt
-
-    The first command could show you some configuration problems, e.g.
-    a "wrong" PATH so that the "wrong" TeX binaries are found or some
-    environment variables that you have set (in a way that confuses
-    Kpathsea). The second command gives you a lot of debugging
-    information. If you cannot find the reason for the problem by
-    the given output, then send it to me in an e-mail.
-
-    If the format files are not there, you need to create them.
-    In case of latex.fmt or tex.fmt, just run
-	texconfig init
-    It will either create the format files for you, or you will get
-    an error message that hopefully helps you to solve your problem.
-    If you need another format file, please refer to the documentation
-    of the package you want to use. See also answer to 21).
-   
 6)  I added some files in the texmf tree. But they are not found.
  
-    You need to run texhash to update the ls-R file. See answer to 14)
+    You need to run texhash to update the ls-R file. See answer to 15)
     as well...
 
 7)  When running some old dvi files through a dvi driver, I get warnings
     about checksum errors.
 
-    The PostScript fonts are completely rearranged and the tfm files have
+    The Postscript fonts are completely rearranged and the tfm files have
     different checksums. If you have the (La)TeX source of your document,
     you can get rid of the messages by running the sources through (La)TeX
     again.
@@ -233,11 +139,11 @@ Answers:
     Yes. The only platform-specific directory is $TETEXDIR/bin. If you
     want to use the same teTeX tree on different platforms, just put
     the binaries for each platform into a different subdirectory of
-    $TETEXDIR/bin, e.g
-         /usr/local/TeX/bin/i486-linux
-         /usr/local/TeX/bin/sparc-solaris2.4
-    You can then mount the whole $TETEXDIR tree on all machines and
-    share almost all the files between them.
+    $prefix/bin, e.g
+         /usr/local/teTeX/bin/i486-linux
+         /usr/local/teTeX/bin/sparc-solaris2.4
+    You can then mount the whole /usr/local/teTeX tree on all machines
+    and share almost all the files between them.
 
 11) After mktexpk and mktextfm successfully generate fonts, kpathsea
     complains and does not use the newly generated font.
@@ -263,34 +169,16 @@ Answers:
 
     Use texconfig and select a different mode as default mode.
 
-13) Is there an easy way to copy .tfm or .pk fonts from a temporal directory
-    to their standard directory below $TEXMFMAIN?
-
-    If the temporal directory is organized according to the TDS, just copy
-    the whole tree using "cp -a" (GNU cp) or use a tar pipe for copying,
-    like:
-      cd /source/dir; tar cf -  | (cd /dest/dir; tar xf -)
-    and remove the contents of the temporal directory afterwards.
-
-    If the temporal directory is not TDS compliant, I suggest to use
-    the fontimport utility. If you want to turn off the "varfonts"
-    feature for fontimport, set USE_VARTEXFONTS to 0 in the environment.
-
-    An easy method to move your fonts from, e.g. $VARTEXFONTS to their
-    "final" standard place is the following (can be used e.g. for a cron
-    command):
-
-    env USE_VARTEXFONTS=0 fontimport -d `kpsexpand '$VARTEXFONTS'`; texhash
-
 14) How about adding program XYY or a macro package ABC to teTeX?
 
     Well, there are some things to take into account:
         - I want to keep the size of the distribution small.
         - I have only a limited amount of time.
-        - teTeX can be installed with a simple 'make world' on the most
-          common UNIX platforms. Adding a new program could break the whole
-          thing.
-    Please think about this before asking me to add something. But if a
+        - teTeX can be installed with a simple
+            ./configure && make && make install
+          on the most common UNIX platforms. Adding a new program could
+          break the whole thing.
+    Please, think about this before asking me to add something. But if a
     really useful thing can be added without much effort and disk space
     usage, I may decide to do that.
 
@@ -300,64 +188,41 @@ Answers:
 15) I want to keep my files separate from the system's files. What do
     I need to do to make sure that tex+friends will find my files?
 
-    If you just have one kind of files (e.g. some metafont source files),
-    put them in one directory and set the corresponding environment
-    variable, in this case: MFINPUTS (for a complete list of search
-    paths and environment variables, see the web2c manual web2c.dvi).
-    Assume that I put some fonts into subdirectories of $HOME/mf-sources.
-    If I do (for csh-like shells):
-      setenv MFINPUTS .:~/mf-sources//:
-    resp.
-      MFINPUTS=.:~/mf-sources//:; export MFINPUTS
-    then metafont will search for font files in:
-      1) the current directory
-      2) $HOME/mf-sources and its subdirectories (subdirectory searching is
-         enabled by the two slashes in the end of the directory)
-      3) the system's directories (this is enabled by the trailing colon)
-
-    If you have several kind of files, I recommend to set up a texmf tree
-    for these files. texmf trees follow a common directory structure,
-    see tds.dvi. To make a new texmf tree known to tex+friends, you have
-    to set up the TEXMF variable. This variable can be set in a texmf.cnf
-    file or in your environment. It lists all known texmf trees, but needs
-    a special syntax, which is:
-       TEXMF={A,B,C}
-    for three texmf trees: A, B and C. You have to add the system's texmf
-    trees here. A trailing colon will do the wrong thing.
-
-    Example: the system's texmf.cnf file has
-      TEXMF = {!!$TEXMFLOCAL:!!$TEXMFMAIN}
-    and I want to add my texmf tree which is ~/texmf.
-
-    Several possible ways to do this:
-      a) edit the texmf.cnf file (if you are allowed) and set
-            TEXMF = {~/texmf,!!$TEXMFLOCAL:!!$TEXMFMAIN}
-      b) set TEXMF in the environment (example for csh):
-            setenv TEXMF '{~/texmf,!!$TEXMFLOCAL:!!$TEXMFMAIN}'
-         Note: if ! is your history character, you might need to quote
-         it like in
-            setenv TEXMF '{~/texmf,\!\!$TEXMFLOCAL:\!\!$TEXMFMAIN}'
-      c) set up a personal texmf.cnf file:
-         Put the line
-            TEXMF = {~/texmf,!!$TEXMFLOCAL:!!$TEXMFMAIN}
-         in a personal texmf.cnf file, e.g. $HOME/config/texmf.cnf
-         and set the variable TEXMFCNF in your environment to make
-         sure your file is read *before* the system's texmf.cnf file:
-            setenv TEXMFCNF ~/config:
-
-     You might also want to create a filename database (ls-R file) to
-     speed up searching your texmf tree. Just enter the command
-          texhash $HOME/texmf
+    If you are a local site administrator, please make use of the texmf
+    tree $TEXMFLOCAL; a single user installation of local additions
+    should go into the texmf tree $HOME/texmf. Mirror the structure
+    of the distributed texmf tree $TEXMFDIST. You can query the system
+    about these locations (TEXMFLOCAL / TEXMFDIST) by running e.g.
+      kpsewhich -var-value TEXMFLOCAL
+
+    The structure of these trees follows the TeX Directory Structure
+    (TDS) standard (revision 1.1). You can view this document by running
+    the command
+      texdoc tds
+
+    The following sections of the uktug faq deal with this topic:
+      $TEXMFDIST/doc/help/faq/uktug-faq/FAQ-instpackages.html
+      $TEXMFDIST/doc/help/faq/uktug-faq/FAQ-wherefiles.html
+      $TEXMFDIST/doc/help/faq/uktug-faq/FAQ-privinst.html
+
+    If texdoc properly knows how to load some html code into your browser,
+    you can view these pages by running e.g.
+      texdoc FAQ-instpackages.html
+
+    One thing mentioned in the uktug faq is so important that I want to
+    repeat here: you should always run the command
+      texhash
+    after you have added some file into a texmf tree.
 
 16) How do I deinstall an old version of teTeX?
 
-    Well, the simple answer is: rm -rf. But there may be some more
-    things you want to do. You may keep a backup of your .pk fonts or of
-    some local files you added to $TEXMF (see question 14, too) before
-    you remove the old directory tree. Note, however that from teTeX 0.2
-    to 0.3, there has been an update of the CM fonts (Knuth has updated
-    the Metafont sources). So you may want to remove your old .pk files
-    and have them recreated with the new sources.
+    Well, the simple answer is: rm -rf. But there may be some more things
+    you want to do. You may keep a backup of your .pk fonts or of some
+    local files you added to $TEXMF before you remove the old directory
+    tree. Note, however that from teTeX 0.2 to 0.3, there has been an
+    update of the CM fonts (Knuth has updated the Metafont sources). So
+    you may want to remove your old .pk files and have them recreated
+    with the new sources.
 
     Another problem is, that there may be some symbolic links in
     /usr/local/{bin,man} (or a similar directory) after you remove the
@@ -439,20 +304,6 @@ Answers:
        
        exec $BINDIR/$THIS_PLATFORM/`basename $0` "$@"
 
-18) Why does not install.sh call fontimport to copy the fonts from my
-    previous teTeX installation?
-
-    Knuth has updated the Metafont sources. You get better .pk fonts if
-    you recalculate them. See also the answers 7) and 8).
-
-19) Under DOS, I used emTeX with LJ fonts. Which metafont mode should I use
-    now with teTeX?
-
-    cx mode. It is common to most 300DPI laser printers. I.e. in
-    texconfig|MODE, choose the line saying:
-
-   	cx        Canon CX, SX, LBP-LX (300dpi)
-
 20) Using the Shrink* Buttons in xdvi, I cannot get back to see the full
     page on the screen.
 
@@ -466,53 +317,15 @@ Answers:
     
 21) Which is the right way of using the AMS fonts/macros with LaTeX?
 
-    Just \usepackage{amsmath} and/or \usepackage{amsfonts}. Read the
-    documentation in $TEXMF/doc/latex/amslatex and $TEXMF/doc/fonts/ams.
+    Just \usepackage{amsmath} and/or \usepackage{amsfonts}. Read
+    the documentation in doc/latex/amsmath, doc/latex/amsfonts and
+    doc/latex/amscls included in the distributed texmf tree.
+
     Do *not* \usepackage{amstex} (amstex.sty is just for compatibility
     with old documents and only for use in LaTeX's 2.09 compatibility mode).
 
     Add \usepackage{amssymb} to get full access to all AMS symbols.
 
-22) teTeX doesn't work with my NEXTSTEP TeXview.app, what should I do ?
-
-    [ NOTE: there are some teTeX/NeXT specific files available via
-    ftp and on the web. The URLs are:
-        http://www.mathi.uni-heidelberg.de/~flight/stepTeX
-    and in the directory teTeX/contrib/NeXT on the ftp servers where
-    teTeX is available, e.g.:
-    ftp://ftp.dante.de/tex-archive/systems/unix/teTeX/contrib/NeXT]
-
-    NEXTSTEP's TeXview.app lacks kpathsearch support. Therefore it
-        doesn't know how to find fonts spread around subdirectories, as in
-        teTeX and TDS. Two possible solutions:
-
-    a) Fetch a modified TeXview.app incorporating kpathsearch. Still in
-           testing, but usable. The primary site for TeXview-kp is
-
-       ftp://zarquon.mathi.uni-heidelberg.de/pub/NeXT/TeX
-
-    b) [Not recommended!] `Flatten' teTeX's font directory
-           layout. Done most easily by setting the "stripsupplier" and
-           "striptypeface" options within texconfig's FONT/OPTIONS. Remove
-           NeXTTeX's font directories and replace them by symlinks into teTeX
-           (replace $TEXMF by the correct value for your installation):
-        
-       rm -rf /usr/lib/tex/fonts/pk /usr/lib/tex/fonts/tfm
-       rm -rf /usr/lib/tex/fonts/vf /usr/lib/tex/ps
-       cd $TEXMF/fonts/tfm ; mv */*/*.tfm .; rmdir */* * >/dev/null
-       cd $TEXMF/fonts/vf ; mv */*/*.vf .; rmdir */* * >/dev/null
-       cd $TEXMF/dvips; mv */* .; rmdir * >/dev/null
-       ln -s $TEXMF/fonts/pk/nextscrn /usr/lib/tex/fonts/pk
-       ln -s $TEXMF/fonts/tfm /usr/lib/tex/fonts/tfm
-       ln -s $TEXMF/fonts/vf /usr/lib/tex/fonts/vf
-       ln -s $TEXMF/dvips /usr/lib/tex/ps
-       ln -s $TEXMF/dvips/config.dfaxhigh $TEXMF/dvips/config.fax
-       texconfig font options stickydir stripsupplier striptypeface
-       texhash
-
-        If you seem to have NEXTSTEP-specific problems with teTeX, contact
-        Gregor Hoffleit <flight@mathi.uni-heidelberg.de>
-
 23) Some things do not work properly. What should I do now?
 
     First, make sure that your "environment" is ok and run
@@ -540,22 +353,22 @@ Answers:
         contact a local TeX user group.
       b) if you think there is a bug in a package contained in teTeX:
         contact the maintainer of the package with a good bug report. Add my
-        Email adress in the Cc field of your bug report, if you want.
+        Email address in the Cc field of your bug report, if you want.
       c) if your problem seems to be teTeX specific (e.g. a problem with
         one of the binaries or shell-scripts), then report it to the
         teTeX mailing list (tetex@dbs.uni-hannover.de). Please
         provide the following information:
 
         * The version of teTeX you have. For example
-                teTeX version is 0.4
-        Indicate if you have any updates installed. (See $TEXMF/updates.dat).
+                teTeX version is 3.0
+          (the version information is displayed by running "texconfig conf").
  
         * The flavor of Unix you are running (Solaris, HP, Linux, etc), and
         its version. For example
                 The system is Solaris 2.4
 
         * The output of the command 
-                texconfig confall
+                texconfig conf
 
         * Possibly a *short* TeX file you have problem running, and
         the whole output of `texcommand filename', say, until the
@@ -584,10 +397,7 @@ Answers:
     papersize. How do I change this to make letterpaper the default?
 
     Simple answer: use texconfig.
-	texconfig dvips paper letter
-	texconfig pdftex paper letter
-	texconfig dvipdfm paper letter
-	texconfig xdvi us
+	texconfig paper letter
 
 28) Why does ghostview display of my texts look so much worse than
     with xdvi?
@@ -605,25 +415,26 @@ Answers:
     the X windows system. If there exists a mfw binary, that one
     has the missing X support you need.
 
-30) I have problems to use the LaTeX 209 llncs styles from Springer.
-
-    LaTeX 2e compatible files for llncs are available from
-      ftp://trick.ntp.springer.de/pub/tex/latex/llncs/latex2e/
-    Use them instead of the old LaTeX 209 style files.
-
-31) What about revtex or llncs styles? I don't get the pre-LaTeX 2e version
-    working with teTeX.
-
-    Forget about the pre-LaTeX 2e versions of these. Get the latest
-    revtex beta from
-      CTAN:macros/latex/contrib/supported/revtex4-beta
-    and llncs from
-      ftp://trick.ntp.springer.de/pub/tex/latex/llncs/latex2e/
-    These should work with LaTeX 2e.
-
 32) How can I get the Euro currency symbol?
 
     In LaTeX, use the marvosym package (documentation: texdoc marvodoc).
     It provides several Euro symbol by the command \EUR. The variants
     \EURtm, \EURhv and \EURcr match are designed to be used together
     with the fonts Times, Helvetica and Courier respectively.
+
+33) Font map files and enc files from my local texmf tree are not found
+    by dvips / pdftex etc.
+
+    With version 1.1 of the TeX Directory Structure, the location for
+    these files was changed. These files are font files and are now
+    stored in fonts/{map,enc}/<syntax>/<package>. So, the solution to
+    your problem is to rearrange these files in your tree and then call
+    the command texhash. More help is given in the release notes section
+    of the teTeX manual (run the command "texdoc TETEXDOC" to read it)
+    and on the web page http://www.tug.org/texlive/mapenc.html.
+
+34) texconfig, updmap and fmtutil just change my personal settings. How
+    can I change global defaults in a multi-user setup?
+
+    Simple answer: use the -sys variant of the tool: texconfig-sys,
+    updmap-sys and fmtutil-sys.