\section{The \file{texmf.cnf} file} \label{sec:texmfcnf} \small \begin{listing}{1} % original texmf.cnf -- runtime path configuration file for kpathsea. % (If you change or delete `original' on the previous line, the % distribution won't install its version over yours.) % Public domain. % % What follows is a super-summary of what this .cnf file can % contain. Please read the Kpathsea manual for more information. % % texmf.cnf is generated from texmf.cnf.in, by replacing @var@ with the % value of the Make variable `var', via a sed file texmf.sed, generated % (once) by kpathsea/Makefile (itself generated from kpathsea/Makefile.in % by configure). % % Any identifier (sticking to A-Za-z_ for names is safest) can be assigned. % The `=' (and surrounding spaces) is optional. % No % or @ in texmf.cnf.in, for the sake of autogeneration. % (However, %'s and @'s can be edited into texmf.cnf or put in envvar values.) % $foo (or ${foo}) in a value expands to the envvar or cnf value of foo. % % Earlier entries (in the same or another file) override later ones, and % an environment variable foo overrides any texmf.cnf definition of foo. % % All definitions are read before anything is expanded, so you can use % variables before they are defined. % % If a variable assignment is qualified with `.PROGRAM', it is ignored % unless the current executable (last filename component of argv[0]) is % named PROGRAM. This foo.PROGRAM construct is not recognized on the % right-hand side. For environment variables, use FOO_PROGRAM. % % Which file formats use which paths for searches is described in the % various programs' and the kpathsea documentation. % % // means to search subdirectories (recursively). % A leading !! means to look only in the ls-R db, never on the disk. % A leading/trailing/doubled : in the paths will be expanded into the % compile-time default. Probably not what you want. % Part 1: Search paths and directories. % The root of everything below. prefix = $SELFAUTOPARENT % You can set an environment variable to override this if you're testing % a new TeX tree, without changing anything else. % % You may wish to use one of the $SELFAUTO... variables here so TeX will % find where to look dynamically. See the manual and the definition % below of TEXMFCNF. % % If you have multiple trees, you can use shell brace notation, for example: % TEXMF = {/usr/local/mytex,/usr/local/othertex} % and also set TEXMFDBS to /usr/local/mytex:/usr/local/othertex. TEXMFLOCAL=/usr/local/texmf TEXMFMAIN = $prefix/share/texmf TEXMFLS_R = $TEXMFLOCAL % Where to look for ls-R files. There need not be an ls-R in the % directories in this path, but if there is one, Kpathsea will use it. TEXMFDBS = $TEXMFLOCAL;$TEXMFMAIN % Where you want generated files to go. Choose one of the texmf trees % listed in $TEXMF. The following is the default: VARTEXMF = $TEXMFLOCAL % The TeX inputs and fonts directories. texdir = {$TEXMFLOCAL/tex,!!$TEXMFMAIN/tex} omegadir ={$TEXMFLOCAL/omega,!!$TEXMFMAIN/omega} fontdir = {$TEXMFLOCAL/fonts,!!$TEXMFMAIN/fonts} dbmain=!!$TEXMFMAIN % dbtex = $texdir dbomega = $omegadir dbfonts = $fontdir % TeX input files -- i.e., anything to be found by \input or \openin, % including .sty, .eps, etc. TEXINPUTS = .;$dbtex// % LaTeX 2e specific macros are stored in latex. % latex209 is not supported, at the request of the authors of LaTeX % latex_inputs = .;$dbtex/latex//;$dbtex/generic// TEXINPUTS.latex = $latex_inputs TEXINPUTS.latextex = $latex_inputs % Omega TEXINPUTS.lambda2e = .;$dbomega/lambda//;$latex_inputs TEXINPUTS.lambda = .;$dbomega/lambda//;$latex_inputs % Fontinst needs to read afm files. TEXINPUTS.fontinst = .;$dbtex//;$dbfonts/afm// % Plain TeX. Have the command tex check all directories as a last % resort, we may have plain-compatible stuff anywhere. plain_inputs = $dbtex/plain//;$dbtex/generic// TEXINPUTS.textex = .;$dbtex//;$plain_inputs TEXINPUTS.tex = .;$plain_inputs;$dbtex// TEXINPUTS.omega = .;$dbomega//;$plain_inputs;$dbtex// % INITEX. May as well make this separate so it can search on disk; % initex is seldom run, and might be used directly after files have been % added, when ls-R may not up be to date. TEXINPUTS.initex = .;$texdir// TEXINPUTS.iniomega = .;$omegadir//;$texdir// % Earlier entries override later ones, so put this last. TEXINPUTS.viromega = .;$dbomega//;$dbtex// TEXINPUTS = .;$dbtex// % Metafont, MetaPost inputs. MFINPUTS = .;{$TEXMFLOCAL,$dbmain}/metafont//;{$dbfonts,$VARTEXFONTS}/source// MPINPUTS = .;{$TEXMFLOCAL,$dbmain}/metapost// % Dump files (fmt/base/mem) for vir{tex,mf,mp} to read (see % web2c/INSTALL), and string pools (.pool) for ini{tex,mf,mp}. It is % silly that we have six paths and directories here (they all resolve to % a single place by default), but historically ... TEXFORMATS = .;{$TEXMFLOCAL,$dbmain}/web2c MFBASES = .;{$TEXMFLOCAL,$dbmain}/web2c MPMEMS = .;{$TEXMFLOCAL,$dbmain}/web2c TEXPOOL = .;{$TEXMFLOCAL,$dbmain}/web2c MFPOOL = .;{$TEXMFLOCAL,$dbmain}/web2c MPPOOL = .;{$TEXMFLOCAL,$dbmain}/web2c % If you have a read-only central font directory and therefore need to % cache MakeTeXPK-created fonts locally, set this as appropriate and % also set the `vartexfonts' feature in MT_FEATURES in MakeTeXnames.cnf. VARTEXFONTS = /var/tex/fonts % Device-independent font metric files. VFFONTS = .;$dbfonts/vf// TFMFONTS = .;$dbfonts/tfm//;$VARTEXFONTS/tfm// % The $MAKETEX_MODE below means the drivers will not use a cx font when % the mode is ricoh. If no mode is explicitly specified, kpse_prog_init % sets MAKETEX_MODE to /, so all subdirectories are searched. See the manual. PKFONTS = .;{$dbfonts,$VARTEXFONTS}/pk/$MAKETEX_MODE// % xdvi needs to find bitmaps for PostScript fonts, which can be % generated by the standalone program gsftopk, among others. PKFONTS.xdvi = .;{$dbfonts,$VARTEXFONTS}/pk/{$MAKETEX_MODE,modeless}// % Similarly for the GF format, which only remains in existence because % Metafont outputs it (and MF isn't going to change). GFFONTS = .;$dbfonts/gf/$MAKETEX_MODE// % A backup for PKFONTS and GFFONTS. Not used for anything. GLYPHFONTS = .;$dbfonts % For texfonts.map and included map files used by MakeTeXPK. % See ftp;//ftp.tug.org/tex/fontname.tar.gz. TEXFONTMAPS = .;{$TEXMFLOCAL,$dbmain}/fontname % BibTeX bibliographies and style files. BIBINPUTS = .;{$TEXMFLOCAL,$dbmain}/bibtex/bib// BSTINPUTS = .;{$TEXMFLOCAL,$dbmain}/bibtex/bst// % MFT style files. MFTINPUTS = .;{$TEXMFLOCAL,$dbmain}/mft// % PostScript headers, prologues (.pro), encodings (.enc) and fonts. TEXPSHEADERS = .;$TEXMFLOCAL/dvips;$dbmain/dvips//;$dbfonts/type1// % PostScript Type 1 outline fonts. T1FONTS = .;$dbfonts/type1//;$TEXMFLOCAL/dvips//;$dbmain/dvips// % PostScript AFM metric files. AFMFONTS = .;$dbfonts/afm// % Dvips' config.* files (this name should not start with `TEX'!). TEXCONFIG = .;$TEXMFLOCAL/dvips;$dbmain/dvips// % Makeindex style (.ist) files. INDEXSTYLE = .;{$TEXMFLOCAL,$dbmain}/makeindex// % Used by DMP (ditroff-to-mpx), called by makempx -troff. TRFONTS = /usr/lib/font/devpost MPSUPPORT = .;{$TEXMFLOCAL,$dbmain}/metapost/support % For xdvi to find mime.types and .mailcap, if they do not exist in % $HOME. These are single directories, not paths. % (But the default mime.types, at least, may well suffice.) MIMELIBDIR = $prefix/etc MAILCAPLIBDIR = $prefix/etc % TeX documentation and source files, for use with kpsewhich. TEXDOCS = .;{$TEXMFLOCAL,$dbmain}/doc// TEXSOURCES = .;{$TEXMFLOCAL,$dbmain}/source// % Omega-related fonts and other files. OFMFONTS = .;{$dbfonts,$VARTEXFONTS}//ofm// OPLFONTS = .;{$dbfonts,$VARTEXFONTS}//opl// OVFFONTS = .;{$dbfonts,$VARTEXFONTS}//ovf// OVPFONTS = .;{$dbfonts,$VARTEXFONTS}//ovp// OTPINPUTS = .;{$TEXMFLOCAL,$dbmain}/omega/otp// OCPINPUTS = .;{$TEXMFLOCAL,$dbmain}/omega/ocp// % For MakeTeX.common, MakeTeX.site, ls-R. web2cdir = {$TEXMFLOCAL,$dbmain}/web2c TEXMFCNF_DIR = $TEXMFMAIN/web2c % The MakeTeX* scripts rely on KPSE_DOT. Do not change it. KPSE_DOT = . % This definition isn't used from this .cnf file itself (that would be % paradoxical), but the compile-time default in paths.h is built from it. % The SELFAUTO* variables are set automatically from the location of % argv[0], in kpse_set_progname. % % About the /. construction; % 1) if the variable is undefined, we'd otherwise have an empty path % element in the compile-time path. This is not meaningful. % 2) if we used /$VARIABLE, we'd end up with // if VARIABLE is defined, % which would search the entire world. % % The TETEXDIR stuff isn't likely to relevant unless you're using teTeX, % but it doesn't hurt. % TEXMFCNF =.;$SELFAUTOLOC;$SELFAUTODIR;$SELFAUTODIR/share/texmf/web2c;$SELFAUTOPARENT;\ $SELFAUTOPARENT/share/texmf/web2c;/.$TETEXDIR;/.{$TEXMFLOCAL,$dbmain}/web2c;$web2cdir % Part 2; Non-path options. % Write .log/.dvi/etc. files here, if the current directory is unwritable. % TEXMFOUTPUT = /tmp % If a dynamic file creation fails, log the command to this file, in % either the current directory or TEXMFOUTPUT. Set to the % empty string or 0 to avoid logging. MISSFONT_LOG = missfont.log % Set to a colon-separated list of words specifying warnings to suppress. % To suppress everything, use TEX_HUSH = all; this is equivalent to % TEX_HUSH = checksum;lostchar;readable;special TEX_HUSH = 0 % Enable system commands via \write18{...}? shell_escape = 0 % Allow TeX \openout on filenames starting with `.' (e.g., .rhosts)? openout_any = 0 % Enable the MakeTeX... scripts by default? These must be set to 0 or 1. % Particular programs can and do override these settings, for example % dvips's -M option. Your first chance to specify whether the scripts % are invoked by default is at configure time. % % These values are ignored if the script names are changed; e.g., if you % set DVIPSMAKEPK to `foo', what counts is the value of the environment % variable/config value `FOO', not the `MAKETEXPK' value. % % MAKETEXTEX = 0 % MAKETEXPK = 0 % MAKETEXMF = 0 % MAKETEXTFM = 0 % What MetaPost runs to make MPX files. This is passed an option -troff % if MP is in troff mode. Set to `0' to disable this feature. MPXCOMMAND = makempx % Part 3; Array and other sizes for TeX (and Metafont and MetaPost). % % If you want to change some of these sizes only for a certain TeX % variant, the usual dot notation works, e.g., % main_memory.hugetex = 20000000 % % If a change here appears to be ignored, try redumping the format file. % Memory. Must be less than 8,000,000. % % main_memory is relevant only to initex, extra_mem_* only to non-ini. % Thus, have to redump the .fmt file after changing main_memory; to add % to existing fmt files, increase the other. (To get an idea of how % much, try \tracingstats=2 in your TeX source file; % web2c/tests/memtest.tex might also be interesting.) % % To increase space for boxes (as might be needed by, e.g., PiCTeX), % increase extra_mem_bot. % main_memory = 263000 % words of memory available; also applies to mf&mp main_memory.hugetex = 1100000 extra_mem_top = 0 % extra high memory for chars, tokens, etc. extra_mem_bot = 0 % extra low memory for boxes, glue, breakpoints, etc. % Words of font info for TeX (total size of all TFM files, approximately). font_mem_size = 100000 font_mem_size.hugetex = 400000 font_mem_size.pdftex = 400000 % Total number of fonts. Must be >= 50 and <= 2000 (without tex.ch changes). font_max = 500 font_max.hugetex = 900 % Extra space for the hash table of control sequences (which allows 10K % names as distributed). hash_extra = 0 hash_extra.hugetex = 10000 hash_extra.pdftex = 10000 % Max number of characters in all strings, including all error messages, % help texts, font names, control sequences. These values apply to TeX and MP. pool_size = 125000 pool_size.hugetex = 500000 pool_size.pdftex = 500000 % Minimum pool space after TeX/MP's own strings; must be at least % 25000 less than pool_size, but doesn't need to be nearly that large. string_vacancies = 25000 string_vacancies.hugetex = 45000 string_vacancies.pdftex = 45000 max_strings = 15000 % max number of strings max_strings.hugetex = 55000 % max number of strings max_strings.pdftex = 55000 % max number of strings pool_free = 5000 % min pool space left after loading .fmt % Hyphenation trie. As distributed, the maximum is 65535; this should % work unless `unsigned short' is not supported or is smaller than 16 % bits. This value should suffice for UK English, US English, French, % and German (for example). To increase, you must change % `ssup_trie_opcode' and `ssup_trie_size' in tex.ch (and rebuild TeX); % the trie will then consume four bytes per entry, instead of two. % % US English, German, and Portuguese; 30000. % German; 14000. % US English; 10000. % trie_size = 64000 hyph_size = 1000 % number of hyphenation exceptions, >610 and <32767. buf_size = 3000 % max length of input lines or control sequence names nest_size = 100 % simultaneous semantic levels (e.g., groups) max_in_open = 15 % simultaneous input files and error insertions param_size = 500 % simultaneous macro parameters save_size = 4000 % for saving values outside current group save_size.pdftex = 30000 % for saving values outside current group save_size.hugetex = 30000 % for saving values outside current group stack_size = 300 % simultaneous input sources % These work best if they are the same as the I/O buffer size, but it % doesn't matter much. Must be a multiple of 8. dvi_buf_size = 16384 % TeX gf_buf_size = 16384 % MF % It's probably inadvisable to change these. At any rate, we must have: % 45 < error_line < 255; % 30 < half_error_line < error_line - 15; % max_print_line < 60 ; % These apply to Metafont and MetaPost as well. error_line = 79 half_error_line = 50 max_print_line = 79 \end{listing} \newpage \section{Catalogue of Packages}\label{cat} \begin{small} \begin{longtable}{llP{.65\textwidth}} \caption{\protect\TeXLive{} packages}\\ \emph{Package} & \emph{Collection} & \emph{Description}\\ \hline \endfirsthead \multicolumn{3}{l}{Catalogue of Packages \emph{continued}}\\ \emph{Package} & \emph{Collection} & \emph{Description}\\ \hline \endhead \mbox{}\\ \endfoot \bibliography{catalog,catextra,tex-live} \end{longtable} \end{small} \nocite{a4} \nocite{aiaa} \nocite{achemso} \nocite{acronym} \nocite{adrlist} \nocite{aguplus} \nocite{aiaa} \nocite{alatex} \nocite{alg} \nocite{algorithms} \nocite{alpha-linux} \nocite{alpha-osf3.2} \nocite{altfont} \nocite{amiweb2c} \nocite{amsfonts} \nocite{amslatex} \nocite{amstex} \nocite{answers} \nocite{apa} \nocite{apl} \nocite{arabtex} \nocite{arseneau} \nocite{ascii} \nocite{astro} \nocite{aurora} \nocite{autotab} \nocite{babel} \nocite{backgammon} \nocite{bakoma} \nocite{barcodes} \nocite{barr} \nocite{base} \nocite{bbding} \nocite{bbm} \nocite{bbtbase} \nocite{bbtdoc} \nocite{beebe} \nocite{beton} \nocite{biblist} \nocite{blue} \nocite{bm} \nocite{booktabs} \nocite{borceux} \nocite{bridge} \nocite{calc} \nocite{calendar} \nocite{calrsfs} \nocite{camel} \nocite{caption} \nocite{carlisle} \nocite{ccfonts} \nocite{cchess} \nocite{cellular} \nocite{changebar} \nocite{chemcono} \nocite{chemsym} \nocite{cheq} \nocite{cherokee} \nocite{chess} \nocite{circ} \nocite{circuit} \nocite{cirth} \nocite{cite} \nocite{cm} \nocite{cmbright} \nocite{cmcyralt} \nocite{cmextra} \nocite{cmpica} \nocite{cmps} \nocite{codepage} \nocite{colorsep} \nocite{concmath} \nocite{concrete} \nocite{context} \nocite{count1to} \nocite{croatian} \nocite{crosswrd} \nocite{csfonts} \nocite{cslatex} \nocite{csplain} \nocite{curves} \nocite{custom-bib} \nocite{dancers} \nocite{dates} \nocite{deleq} \nocite{devanagari} \nocite{dialogl} \nocite{dinbrief} \nocite{doc1} \nocite{doc2} \nocite{dotseqn} \nocite{draftcopy} \nocite{dratex} \nocite{dropping} \nocite{dtk} \nocite{duerer} \nocite{dvips} \nocite{dvipsbas} \nocite{ean} \nocite{easy} \nocite{ec} \nocite{ecc} \nocite{edmac} \nocite{eepic} \nocite{eiad} \nocite{elsevier} \nocite{elvish} \nocite{endfloat} \nocite{engwar} \nocite{envbig} \nocite{envlab} \nocite{eplain} \nocite{epslatex} \nocite{eqname} \nocite{eqnarray} \nocite{euler} \nocite{everysel} \nocite{everyshi} \nocite{exam} \nocite{exams} \nocite{expdlist} \nocite{export} \nocite{fancyhdr} \nocite{fancyheadings} \nocite{fancyvrb} \nocite{fax} \nocite{fc} \nocite{feynmf} \nocite{float} \nocite{floatfig} \nocite{floatflt} \nocite{fncychap} \nocite{foiltex} \nocite{fontinst} \nocite{fontmisc} \nocite{fontname} \nocite{fonts} \nocite{footnote} \nocite{footnpag} \nocite{formats} \nocite{fp} \nocite{french} \nocite{fribrief} \nocite{fundus} \nocite{futhark} \nocite{g-brief} \nocite{gb4e} \nocite{general} \nocite{genmisc} \nocite{geometry} \nocite{german} \nocite{germbib} \nocite{go} \nocite{gothic} \nocite{graphics} \nocite{gray} \nocite{hands} \nocite{harpoon} \nocite{harvard} \nocite{harvmac} \nocite{hh} \nocite{histogr} \nocite{hppa1.1-hpux10.20} \nocite{hppa1.1-hpux9.05} \nocite{html} \nocite{hyper} \nocite{hyperref} \nocite{hyphen} \nocite{i386-linux} \nocite{i586-freebsd2.2} \nocite{i686-linux} \nocite{ieeepes} \nocite{ifacmtg} \nocite{indxcite} \nocite{info} \nocite{inputenc} \nocite{ipa} \nocite{isostds} \nocite{jadetex} \nocite{jknappen} \nocite{jsmisc} \nocite{jura} \nocite{knuth} \nocite{koma-script} \nocite{kuvio} \nocite{labels} \nocite{lamstex} \nocite{lastpage} \nocite{lgreek} \nocite{lineno} \nocite{listings} \nocite{localloc} \nocite{logic} \nocite{lollipop} \nocite{lshort} \nocite{ltablex} \nocite{ltxdoc} \nocite{ltxmisc} \nocite{lw35ps} \nocite{ly1} \nocite{mab-nextstep3} \nocite{mailing} \nocite{makeindex} \nocite{malvern} \nocite{mapcodes} \nocite{maple} \nocite{mathcomp} \nocite{mcite} \nocite{mdwtools} \nocite{mff} \nocite{mflogo} \nocite{mfmisc} \nocite{mfnfss} \nocite{mfpic} \nocite{mftoeps} \nocite{midnight} \nocite{minitoc} \nocite{mips-irix4.0.5} \nocite{mips-irix5.3} \nocite{mips-irix6.3} \nocite{mips-ultrix4.4} \nocite{misc} \nocite{misc209} \nocite{mnras} \nocite{monster} \nocite{moreverb} \nocite{mpbase} \nocite{mpfnmark} \nocite{mslapa} \nocite{mtbe} \nocite{musictex} \nocite{musixtex} \nocite{myletter} \nocite{nassflow} \nocite{natbib} \nocite{newalg} \nocite{newsletr} \nocite{newthm} \nocite{niceframe} \nocite{nomencl} \nocite{ntgclass} \nocite{numline} \nocite{objectz} \nocite{oca} \nocite{ocr-a} \nocite{ocr-b} \nocite{ogham} \nocite{ogonek} \nocite{oldstyle} \nocite{osmanian} \nocite{ot2cyr} \nocite{overword} \nocite{pandora} \nocite{paper} \nocite{parallel} \nocite{patch} \nocite{pb-diagram} \nocite{pdcmac} \nocite{pdf} \nocite{pdftex} \nocite{phonetic} \nocite{physe} \nocite{phyzzx} \nocite{picinpar} \nocite{pictex} \nocite{piff} \nocite{plainmisc} \nocite{plaintex} \nocite{plfonts} \nocite{plgraph} \nocite{pmgraph} \nocite{poligraf} \nocite{prelim2e} \nocite{prettyref} \nocite{progkeys} \nocite{program} \nocite{proofs} \nocite{psfonts} \nocite{psfrag} \nocite{psizzl} \nocite{pslatex} \nocite{psnfss} \nocite{psnfssx} \nocite{pspicture} \nocite{pstricks} \nocite{punk} \nocite{qobitree} \nocite{qsymbols} \nocite{ragged2e} \nocite{rcs} \nocite{realcalc} \nocite{refman} \nocite{revtex} \nocite{rlepsf} \nocite{rotating} \nocite{rotfloat} \nocite{rplain} \nocite{rs6000-aix3.2.5} \nocite{rs6000-aix4.1.1} \nocite{sauter} \nocite{scale} \nocite{script} \nocite{semantic} \nocite{seminar} \nocite{setspace} \nocite{shadbox} \nocite{shadethm} \nocite{showlabels} \nocite{siam} \nocite{siggraph} \nocite{slidenotes} \nocite{smallcap} \nocite{songbook} \nocite{sparc-linux} \nocite{sparc-solaris2.4} \nocite{sparc-solaris2.5} \nocite{sparc-sunos4.1.3} \nocite{sprite} \nocite{ssqquote} \nocite{startex} \nocite{stmaryrd} \nocite{subeqn} \nocite{subeqnarray} \nocite{subfigure} \nocite{supertabular} \nocite{swift} \nocite{tap} \nocite{taylor} \nocite{tbe} \nocite{tengwar} \nocite{tex-ps} \nocite{texdraw} \nocite{texip} \nocite{texlive} \nocite{text1} \nocite{textcomp} \nocite{textfit} \nocite{textmerg} \nocite{thesis} \nocite{timesht} %\nocite{timing} \nocite{tipa} \nocite{tools} \nocite{tracking} \nocite{treesvr} \nocite{treetex} \nocite{tugboat} \nocite{type1cm} \nocite{typehtml} \nocite{uaclasses} \nocite{ucthesis} \nocite{ulsy} \nocite{umlaute} \nocite{umrand} \nocite{underlin} \nocite{useful} \nocite{utthesis} \nocite{uwthesis} \nocite{vdm} \nocite{vector} \nocite{vertex} \nocite{vita} \nocite{vrb} \nocite{vrsion} \nocite{wasy} \nocite{wasysym} \nocite{williams} \nocite{win32} \nocite{wnri} \nocite{wsuipa} \nocite{xymtex} \nocite{xypic} \nocite{yhmath} \nocite{youngtab} \nocite{ytex} \nocite{zed-csp}