Mercurial > octave-nkf
view kpathsea/texmf.cnf.in @ 3000:86d3a6fc4c84
[project @ 1997-05-23 03:09:13 by jwe]
author | jwe |
---|---|
date | Fri, 23 May 1997 03:10:11 +0000 |
parents | faa5d0421460 |
children |
line wrap: on
line source
% 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 = @prefix@ % 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} % Also set TEXMFDBS to /usr/local/mytex:/usr/local/othertex, % and set TEXMFMAIN to whichever is the main tree (with ./web2c, etc.), % and set TEXMFLS_R to the tree where you want generated files to go % TEXMF = @texmf@ % Change this if you have multiple trees or MakeTeX* will fail: TEXMFMAIN = $TEXMF % (this is the default) TEXMFLS_R = $TEXMFMAIN % (this is the default) TEXMFCNF_DIR = $TEXMFMAIN % 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 = $TEXMF % The TeX inputs and fonts directories. texdir = @texinputdir@ fontdir = @fontdir@ % To avoid searching the filesystem, use the commented-out definitions here. %dbtex = !!$texdir %dbfonts = !!$fontdir dbtex = $texdir 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/, macros that can only be % used with 2.09 in latex209/. In addition, we look in the directory % latex2, useful for macros that were written for 2.09 and do not % mention 2e at all, but can be used with 2e. latex209_inputs = .:$dbtex/latex209//:$dbtex/latex//:$dbtex/generic// latex2e_inputs = .:$dbtex/latex//:$dbtex/latex209//:$dbtex/generic// TEXINPUTS.latex209 = $latex209_inputs TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_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.tex = .:$plain_inputs:$dbtex// % other plain-based formats TEXINPUTS.amstex = .:$dbtex/amstex//:$plain_inputs TEXINPUTS.ftex = .:$dbtex/formate//:$plain_inputs TEXINPUTS.texinfo = .:$dbtex/texinfo//:$plain_inputs % 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// % Earlier entries override later ones, so put this last. TEXINPUTS = .:$dbtex// % Metafont, MetaPost inputs. MFINPUTS = .:@mfinputdir@//:{$dbfonts,$VARTEXFONTS}//source// MPINPUTS = .:@mpinputdir@// % 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 = .:@fmtdir@ MFBASES = .:@basedir@ MPMEMS = .:@memdir@ TEXPOOL = .:@texpooldir@ MFPOOL = .:@mfpooldir@ MPPOOL = .:@mppooldir@ % 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,$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 = .:$TEXMF/fontname % BibTeX bibliographies and style files. BIBINPUTS = .:$TEXMF/bibtex/bib// BSTINPUTS = .:$TEXMF/bibtex/bst// % MFT style files. MFTINPUTS = .:$TEXMF/mft// % PostScript headers, prologues (.pro), encodings (.enc) and fonts. TEXPSHEADERS = .:@psheaderdir@//:$dbfonts//type1// % PostScript Type 1 outline fonts. T1FONTS = .:$dbfonts//type1// % PostScript AFM metric files. AFMFONTS = .:$dbfonts//afm// % Dvips' config.* files (this name should not start with `TEX'!). TEXCONFIG = .:@dvipsdir@// % Makeindex style (.ist) files. INDEXSTYLE = .:$TEXMF/makeindex// % Used by DMP (ditroff-to-mpx), called by makempx -troff. TRFONTS = /usr/lib/font/devpost MPSUPPORT = .:$TEXMF/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 = .:$TEXMF/doc// TEXSOURCES = .:$TEXMF/source// % Omega-related fonts and other files. OFMFONTS = .:{$dbfonts,$VARTEXFONTS}//ofm// OPLFONTS = .:{$dbfonts,$VARTEXFONTS}//opl// OVFFONTS = .:{$dbfonts,$VARTEXFONTS}//ovf// OVPFONTS = .:{$dbfonts,$VARTEXFONTS}//ovp// OTPINPUTS = .:$TEXMF/omega/otp// OCPINPUTS = .:$TEXMF/omega/ocp// % 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. % web2cdir = @web2cdir@ TEXMFCNF = .:$SELFAUTOLOC:$SELFAUTODIR:$SELFAUTODIR/share/texmf/web2c:$SELFAUTOPARENT:$SELFAUTOPARENT/share/texmf/web2c:/.$TETEXDIR:/.$TEXMF/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 total. % % 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 extra_mem_*. (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. % % For some xy-pic samples, you may need as much as 700000 words of memory. % For the vast majority of documents, 60000 or less will do. % main_memory = 263000 % words of inimemory available; also applies to inimf&mp 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 % Total number of fonts. Must be >= 50 and <= 2000 (without tex.ch changes). font_max = 500 % Extra space for the hash table of control sequences (which allows 10K % names as distributed). hash_extra = 0 % 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 % 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 max_strings = 15000 % 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 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