diff options
Diffstat (limited to 'Master/texmf-dist/doc/tetex/teTeX-FAQ')
-rw-r--r-- | Master/texmf-dist/doc/tetex/teTeX-FAQ | 440 |
1 files changed, 0 insertions, 440 deletions
diff --git a/Master/texmf-dist/doc/tetex/teTeX-FAQ b/Master/texmf-dist/doc/tetex/teTeX-FAQ deleted file mode 100644 index 025a668de92..00000000000 --- a/Master/texmf-dist/doc/tetex/teTeX-FAQ +++ /dev/null @@ -1,440 +0,0 @@ -This is the FAQ for teTeX -- a TeX distribution for UNIX compatible -systems. If you have questions about some points that remain unclear, -or if you think that things could be described better, just drop me -a line. My Email address: - - Thomas Esser <te@dbs.uni-hannover.de> - - -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 - 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? - - 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/ - -1) Is there a mailing list for teTeX? - - 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 - tetex-announce@dbs.uni-hannover.de - To subscribe to one of these lists, send a message containing the line - subscribe tetex - or - subscribe tetex-announce - resp. to majordomo@dbs.uni-hannover.de . The majordomo server - understands a few more commands. To get more help about our - server, send a mail with the line 'help' in the body. - Note that announcements are posted into both lists, so if you are - interested in discussions and announcements, you only need to - subscribe to the tetex list. - -2) Now that I know that there is a mailing list: is there an archive - of the list? - - Yes. Just send a message with the line - get tetex archive - to majordomo@dbs.uni-hannover.de . - -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 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 - 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. - -8) What is the best method to get pk fonts in a batch job? - - If you do have lots of dvi files (e.g. the documentation of teTeX), - just run the allneeded script on them. It runs all those files - through dvips (but output is send to /dev/null and not to a printer), - and thus calculates all fonts that are needed to print these files - (or preview with the same mode). - - Example: - allneeded `kpsexpand '$TEXMFMAIN'`/doc >& /tmp/allneeded.log & - - The above command calculates the pk files for all the installed - documentation in a background job. - - If you do not have many dvi files, you can use the allcm and/or - allec scripts (allcm is for Computer Modern fonts, and allec for the - ec fonts). You need to have LaTeX installed and the scripts calculate - the fonts for all sizes and shapes that are used in typical LaTeX - documents. - -9) What to do if I need the fonts for several modes? - - You only need the modes together with a printer or for previewing. You - should add a dvips configuration file for each printer using texconfig - and use the most common printing mode for previewing. - Then, any of the above scripts in 8) (allneeded, allcm, allec) can be - given an argument of the form -P PRINTER (where PRINTER must be a known - printer for dvips). This will calculate the fonts with the mode of - the printer PRINTER. - - Example: - For dvips I have configured the printer lp to have the mode - ljfour. To get all ec fonts with ljfour mode, I would enter: - - allec -P lp - - If you do not have a dvips configuration file that corresponds to a - specific mode, you can still enter the mode on the command line. - Note however, that you should specify the corresponding resolution - as well. - - Example: - To get all fonts in cx mode (CanonCX mode is used by many 300dpi - printers), give the command: - - allcm -D 300 -mode cx - - The flags -D and -mode are directly passed down to dvips. - -10) Can I share the teTeX directory tree between different platforms? - - 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 - $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. - - If you happen to see output like this: - ... - Transcript written on ecti1000.log. - /usr/local/teTeX/texmf/fonts/tfm/jknappen/ec/ecti1000.tfm - kpathsea: Appending font creation commands to missfont.log. - ... - then your shell is probably very broken. This problem is known with - the original bash 1.14.3 that has many problems with exit codes and - trap handling. Try the following line: - - sh -c 'exit 1'; echo $? - - The buggy bash gives 127 as result. Fixes for these problems have been - available e.g. from the internet newsgroup gnu.bash.bug, so not all - instances of bash 1.14.3 are broken. Later versions of bash should not - have that bug. - -12) mktextfm runs Metafont with a mode that I do not like. - - Use texconfig and select a different mode as default mode. - -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 - ./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. - - Another possibility is, that things are added to the contrib directory - of 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? - - 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 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 - old teTeX directory tree and you may want to remove those links, - too. A simple way to do this, is the following: - - cd /usr/local/bin - sh -c 'for i in *; do test -s $i || echo $i; done' - - This loop echo'es all files with zero length, especially all stale - symbolic links. If you want to remove all files that are shown by the - command above, you can do this with: - - sh -c 'for i in *; do test -s $i || rm -f $i; done' - - You can repeat the above steps for other directories, as well - (e.g. /usr/local/man/man1 and /usr/local/man/man5). - -17) How do I manage to execute the right binaries on each platform? - - Assuming that you have binaries for several platforms installed, your - binaries are in $TETEXDIR/bin/PLATFORM. The first thing you can try is - to set up your PATH with - SYSDIR=`uname -m`-`uname -s` - PATH=$TETEXDIR/bin/$SYSDIR:... - You may need to rename the PLATFORM directories for this method. - - Another thing that may help is to include a local directory in your - PATH (e.g. /usr/local/bin) and create symbolic links for the binaries: - linux# ln -sf /usr/local/teTeX/bin/i486-linux/* /usr/local/bin - sun# ln -sf /usr/local/teTeX/bin/sparc-solaris2.4/* /usr/local/bin - ... - - If you do not like the uname-method for your PATH and the symlink - method, you may consider installing a small wrapper program that - calls the programs for the right platform. Install the wrapper in - $TETEXDIR/bin and create a symbolic link for each binary. - - Here an example: - TETEXDIR=/usr/local/teTeX - cd $TETEXDIR/bin - vi platf_wrapper # see script below ... - chmod +x platf_wrapper - list=`ls i486-linux` # get a list of programs. - for i in $list; do - ln -s platf_wrapper $i - done - - Tell your users to include $TETEXDIR/bin in their PATH. Make sure - that TETEXDIR is either set to an absolute path (e.g. /usr/local/teTeX) - or to $SELFAUTODIR (but not $SELFAUTOPARENT), since the programs are - now found one directory level earlier. - - Now the sample wrapper. Customize, if you need: - - #!/bin/sh - - # the path to the directories with the subdirs for each platform - BINDIR=/usr/local/teTeX/bin - - # export the variable. If we are called again, - # we do not need to recalculate. - export THIS_PLATFORM - - case "$THIS_PLATFORM" in - "") - case "`uname -s`" in - Linux) - THIS_PLATFORM=i486-linux;; - SunOS) - THIS_PLATFORM=sparc-solaris2.4;; - IRIX) - THIS_PLATFORM=mips-irix5.3;; - *) - echo "$0: fatal error: system not detected." >&2 - exit 1 - esac;; - esac - - exec $BINDIR/$THIS_PLATFORM/`basename $0` "$@" - -20) Using the Shrink* Buttons in xdvi, I cannot get back to see the full - page on the screen. - - The four buttons can be configured via X resources. Just add - them either to your personal X resources (usually ~/.Xdefaults) - or to xdvi's global configuration file XDvi which resides in - $TEXMFMAIN/xdvi. Such a resource setting might look like this: - XDvi*shrinkButton3: 6 - (This example configures button 3 to do a shrinking by a factor of 6). - - -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 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. - -23) Some things do not work properly. What should I do now? - - First, make sure that your "environment" is ok and run - texconfig confall - This gives you an idea about which binaries are found along your - PATH and if you have set some environment variables that might - confuse teTeX's programs. If in doubt, unset all variables that - are set in the "environment variables" section of the output. - - If binaries other than teTeX's are found, then change the definition - of your PATH. Put the directory containing teTeX's binaries earlier - into your PATH, so that teTeX's binaries are found before any other - TeX related stuff. - - Then, your ls-R file might be out of date. Run - texhash - and see if your problem goes away. - - If your problem is due to old LaTeX209 files that do not work with - LaTeX2e, then read $TEXMF/doc/latex/base/clsguide.dvi. - - If you cannot solve your problem by yourself, then - a) if you think your problem is a general question about TeX/LaTeX: - ask in some Newsgroup, such as comp.text.tex for help, or try to - 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 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 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 conf - - * Possibly a *short* TeX file you have problem running, and - the whole output of `texcommand filename', say, until the - first error. - -24) I get a error message about "TeX capacity exceeded". What can I do? - - If there is a constant in the system's texmf.cnf file, just enlarge - this (by editing the texmf.cnf file) and run the command - texconfig init - -25) The scrollbars of xdvi do not make sense to me. How do I move backwards? - - The scrollbars are what one calls Athena scrollbars. To scroll - forward, click the left mouse button on the location you would want - to scroll to the beginning of the displayed area. To scroll backward, - click the right mouse button on where you want to scroll the beginning - of the displayed area to. Click the middle mouse button for "dragging" - the beginning of the displayed area around. - -26) Is teTeX freely redistributable? - - Yes. All parts of teTeX have been classified as being free software. - -27) dvips, pdftex, dvipdfm and xdvi use the European A4 size as default - papersize. How do I change this to make letterpaper the default? - - Simple answer: use texconfig. - texconfig paper letter - -28) Why does ghostview display of my texts look so much worse than - with xdvi? - - xdvi does antialiasing. If your version of ghostscript is - sufficiently new, it has the x11alpha device. Check for this with - gs -h - If it has, then putting - Ghostview*arguments: -sDEVICE=x11alpha - in your .Xdefault file (typically) will make ghostview use an - anti-aliasing display as well, at the cost of display speed. - -29) Metafont does not support the X display. - It may be that your Metafont binary is compiled without support for - the X windows system. If there exists a mfw binary, that one - has the missing X support you need. - -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. |