misc fixes to LM
[light-and-matter.git] / sn / texmf.cnf
bloba28343d7235863a6a058d882aa51faf48fb42772
1 % original texmf.cnf -- runtime path configuration file for kpathsea.
2 % (If you change or delete `original' on the previous line, the
3 % distribution won't install its version over yours.)
4 % Public domain.
5
6 % What follows is a super-summary of what this .cnf file can
7 % contain. Please read the Kpathsea manual for more information.
8
9 % texmf.cnf is generated from texmf.in, by replacing @var@ with the
10 % value of the Make variable `var', via a sed file texmf.sed, generated
11 % (once) by kpathsea/Makefile (itself generated from kpathsea/Makefile.in
12 % by configure).
13
14 % Any identifier (sticking to A-Za-z_ for names is safest) can be assigned.
15 % The `=' (and surrounding spaces) is optional.
16 % No % or @ in texmf.in, for the sake of autogeneration.
17 % (However, %'s and @'s can be edited into texmf.cnf or put in envvar values.)
18 % $foo (or ${foo}) in a value expands to the envvar or cnf value of foo.
19
20 % Earlier entries (in the same or another file) override later ones, and
21 % an environment variable foo overrides any texmf.cnf definition of foo.
22
23 % All definitions are read before anything is expanded, so you can use
24 % variables before they are defined. 
25
26 % If a variable assignment is qualified with `.PROGRAM', it is ignored
27 % unless the current executable (last filename component of argv[0]) is
28 % named PROGRAM.  This foo.PROGRAM construct is not recognized on the
29 % right-hand side. For environment variables, use FOO_PROGRAM.
30
31 % Which file formats use which paths for searches is described in the
32 % various programs' and the kpathsea documentation.
33
34 % // means to search subdirectories (recursively).
35 % A leading !! means to look only in the ls-R db, never on the disk.
36 % A leading/trailing/doubled ; in the paths will be expanded into the
37 %   compile-time default. Probably not what you want.
38
39 % You can use brace notation, for example: /usr/local/{mytex:othertex}
40 % expands to /usr/local/mytex:/usr/local/othertex.  Instead of the path
41 % separator you can use a comma: /usr/local/{mytex,othertex} also expands
42 % to /usr/local/mytex:/usr/local/othertex.  However, the use of the comma
43 % instead of the path separator is deprecated.
45 % The text above assumes thet path separator is a colon (:).  Non-UNIX
46 % systems use different path separators, like the semicolon (;).
48 \f Part 1: Search paths and directories.
50 % You can set an environment variable to override TEXMF if you're testing
51 % a new TeX tree, without changing anything else.
52
53 % You may wish to use one of the $SELFAUTO... variables here so TeX will
54 % find where to look dynamically.  See the manual and the definition
55 % below of TEXMFCNF.
57 % The main tree, which must be mentioned in $TEXMF, below:
58 TEXMFMAIN = $SELFAUTOPARENT/share/texmf
60 % A place for local additions to a "standard" texmf tree.  For example:
61 %   TEXMFLOCAL = $SELFAUTOPARENT/share/texmf.local
63 % If defined, teTeX's texconfig stores modifications here (instead of the
64 % TEXMFMAIN tree).
65 %   VARTEXMF = $SELFAUTOPARENT/share/texmf-var
67 % User texmf trees can be catered for like this...
68 %   HOMETEXMF = $HOME/texmf
70 % Now, list all the texmf trees. If you have multiple trees you can
71 % use shell brace notation, like this:
72 %   TEXMF = {$HOMETEXMF,!!$TEXMFLOCAL,!!$TEXMFMAIN}
73 % The braces are necessary.  If you set VARTEXMF, you also have to
74 %   - list $VARTEXMF in the TEXMF definition;
75 %   - make sure that $VARTEXMF precedes $TEXMFMAIN in the TEXMF definition.
76 TEXMF = !!$TEXMFMAIN
78 % The system trees.  These are the trees that are shared by all the users.
79 SYSTEXMF = $TEXMF
81 % Where generated fonts may be written.  This tree is used when the sources
82 % were found in a system tree and either that tree wasn't writable, or the
83 % varfonts feature was enabled in MT_FEATURES in mktex.cnf.
84 VARTEXFONTS = /var/tmp/texfonts
86 % Where to look for ls-R files.  There need not be an ls-R in the
87 % directories in this path, but if there is one, Kpathsea will use it.
89 % Remove $VARTEXFONTS from TEXMFDBS if the VARTEXFONTS directory is below
90 % one of the TEXMF directories (avoids overlapping ls-R files).
91 TEXMFDBS = $TEXMF;$VARTEXFONTS
93 % It may be convenient to define TEXMF like this:
94 %   TEXMF = {$HOMETEXMF,!!$TEXMFLOCAL,!!$TEXMFMAIN,$HOME}
95 % which allows users to set up entire texmf trees, and tells TeX to
96 % look in places like ~/tex and ~/bibtex.  If you do this, define TEXMFDBS
97 % like this:
98 %   TEXMFDBS = $HOMETEXMF;$TEXMFLOCAL;$TEXMFMAIN;$VARTEXFONTS
99 % or mktexlsr will generate an ls-R file for $HOME when called, which is
100 % rarely desirable.  If you do this you'll want to define SYSTEXMF like
101 % this:
102 %   SYSTEXMF = $TEXMFLOCAL;$TEXMFMAIN
103 % so that fonts from a user's tree won't escape into the global trees.
105 % On some systems, there will be a system tree which contains all the font
106 % files that may be created as well as the formats.  For example
107 %   VARTEXMF = /var/lib/texmf
108 % is used on many Linux systems.  In this case, set VARTEXFONTS like this
109 %   VARTEXFONTS = $VARTEXMF/fonts
110 % and do not mention it in TEXMFDBS (but _do_ mention VARTEXMF).
113 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
114 % Usually you will not need to edit any of the other variables in part 1. %
115 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
117 % WEB2C is for Web2C specific files.  The current directory may not be
118 % a good place to look for them.
119 WEB2C = $TEXMF/web2c
121 % TEXINPUTS is for TeX input files -- i.e., anything to be found by \input
122 % or \openin, including .sty, .eps, etc. 
124 % Plain TeX.  Have the command tex check all directories as a last
125 % resort, we may have plain-compatible stuff anywhere.
126 TEXINPUTS.tex = .;$TEXMF/tex/{plain,generic,}//
128 % Other plain-based formats.
129 TEXINPUTS.amstex = .;$TEXMF/tex/{amstex,plain,generic,}//
130 TEXINPUTS.csplain = .;$TEXMF/tex/{csplain,plain,generic,}//
131 TEXINPUTS.eplain  = .;$TEXMF/tex/{eplain,plain,generic,}//
132 TEXINPUTS.ftex = .;$TEXMF/tex/{formate,plain,generic,}//
133 TEXINPUTS.jadetex = .;$TEXMF/tex/{jadetex,plain,generic,}//
134 TEXINPUTS.mex = .;$TEXMF/tex/{mex,plain,generic,}//
135 TEXINPUTS.mex-pl = .;$TEXMF/tex/{mex,plain,generic,}//
136 TEXINPUTS.texinfo = .;$TEXMF/tex/{texinfo,plain,generic,}//
138 % LaTeX 2e specific macros are stored in latex/, macros that can only be
139 % used with 2.09 in latex209/.  In addition, we look in the directory
140 % latex209, useful for macros that were written for 2.09 and do not
141 % mention 2e at all, but can be used with 2e.
142 TEXINPUTS.cslatex = .;$TEXMF/tex/{cslatex,csplain,latex,generic,}//
143 TEXINPUTS.platex  = .;$TEXMF/tex/{platex,latex,generic,}//
144 TEXINPUTS.platex-pl  = .;$TEXMF/tex/{platex,latex,generic,}//
145 TEXINPUTS.latex = .;$TEXMF/tex/{latex,generic,}//
146 TEXINPUTS.latex209 = .;$TEXMF/tex/{latex209,generic,latex,}//
148 % Fontinst needs to read afm files.
149 TEXINPUTS.fontinst = .;$TEXMF/tex//;$TEXMF/fonts/afm//
151 % MLTeX.
152 TEXINPUTS.frlatex = .;$TEXMF/{mltex,tex}/{french,latex,generic,}//
153 TEXINPUTS.frtex   = .;$TEXMF/{mltex,tex}/{french,plain,generic,}//
154 TEXINPUTS.mllatex = .;$TEXMF/{mltex,tex}/{latex,generic,}//
155 TEXINPUTS.mltex = .;$TEXMF/{mltex,tex}/{plain,generic,}//
157 % e-TeX.  This form of the input paths is borrowed from teTeX.  A certain
158 % variant of TDS is assumed here, unaffected by the build variables.
159 TEXINPUTS.elatex   = .;$TEXMF/{etex,tex}/{latex,generic,}//
160 TEXINPUTS.etex     = .;$TEXMF/{etex,tex}/{plain,generic,}//
162 % pdfTeX.  This form of the input paths is borrowed from teTeX.  A certain
163 % variant of TDS is assumed here, unaffected by the build variables.
164 TEXINPUTS.pdfcslatex = .;$TEXMF/{pdftex,tex}/{cslatex,csplain,latex,generic,}//
165 TEXINPUTS.pdfcsplain = .;$TEXMF/{pdftex,tex}/{csplain,plain,generic,}//
166 TEXINPUTS.pdfjadetex = .;$TEXMF/{pdftex,tex}/{jadetex,plain,generic,}//
167 TEXINPUTS.pdflatex = .;$TEXMF/{pdftex,tex}/{latex,generic,}//
168 TEXINPUTS.pdfmex   = .;$TEXMF/{pdftex,tex}/{mex,plain,generic,}//
169 TEXINPUTS.pdfmex-pl = .;$TEXMF/{pdftex,tex}/{mex,plain,generic,}//
170 TEXINPUTS.pdftex   = .;$TEXMF/{pdftex,tex}/{plain,generic,}//
171 TEXINPUTS.pdftexinfo = .;$TEXMF/{pdftex,tex}/{texinfo,plain,generic,}//
173 % pdfeTeX.
174 TEXINPUTS.pdfelatex = .;$TEXMF/{pdfetex,pdftex,etex,tex}/{latex,generic,}//
175 TEXINPUTS.pdfetex   = .;$TEXMF/{pdfetex,pdftex,etex,tex}/{plain,generic,}//
176 TEXINPUTS.pdfemex   = .;$TEXMF/{pdfetex,pdftex,etex,tex}/{mex,plain,generic,}//
177 TEXINPUTS.pdfemex-pl = .;$TEXMF/{pdfetex,pdftex,etex,tex}/{mex,plain,generic,}//
179 % Omega.
180 TEXINPUTS.lambda = .;$TEXMF/{omega,tex}/{lambda,latex,generic,}//
181 TEXINPUTS.omega = .;$TEXMF/{omega,tex}/{plain,generic,}//
183 % Context macros by Hans Hagen:
184 TEXINPUTS.context = .;$TEXMF/{pdftex,etex,tex}/{context,plain,generic,}//
186 % odd formats  needing their own paths
187 TEXINPUTS.lamstex  = .;$TEXMF/tex/{lamstex,plain,generic,}//
188 TEXINPUTS.lollipop = .;$TEXMF/tex/{lollipop,plain,generic,}//
190 % Earlier entries override later ones, so put this last.
191 TEXINPUTS = .;$TEXMF/tex/{generic,}//
193 % Metafont, MetaPost inputs.
194 MFINPUTS = .;$TEXMF/metafont//;{$TEXMF/fonts,$VARTEXFONTS}/source//
195 MPINPUTS = .;$TEXMF/metapost//
197 % Dump files (fmt/base/mem) for vir{tex,mf,mp} to read (see web2c/INSTALL),
198 % and string pools (.pool) for ini{tex,mf,mp}.  It is silly that we have six
199 % paths and directories here (they all resolve to a single place by default),
200 % but historically ...
201 TEXFORMATS = .;$TEXMF/web2c
202 MFBASES = .;$TEXMF/web2c
203 MPMEMS = .;$TEXMF/web2c
204 TEXPOOL = .;$TEXMF/web2c
205 MFPOOL = .;$TEXMF/web2c
206 MPPOOL = .;$TEXMF/web2c
208 % Device-independent font metric files.
209 VFFONTS = .;$TEXMF/fonts/vf//
210 TFMFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/tfm//
212 % The $MAKETEX_MODE below means the drivers will not use a cx font when
213 % the mode is ricoh.  If no mode is explicitly specified, kpse_prog_init
214 % sets MAKETEX_MODE to /, so all subdirectories are searched.  See the manual.
215 % The modeless part guarantees that bitmaps for PostScript fonts are found.
216 PKFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/pk/{$MAKETEX_MODE,modeless}//
218 % Similarly for the GF format, which only remains in existence because
219 % Metafont outputs it (and MF isn't going to change).
220 GFFONTS = .;$TEXMF/fonts/gf/$MAKETEX_MODE//
222 % A backup for PKFONTS and GFFONTS. Not used for anything.
223 GLYPHFONTS = .;$TEXMF/fonts
225 % A place to puth everything that doesn't fit the other font categories.
226 MISCFONTS = .;$TEXMF/fonts/misc//
228 % For texfonts.map and included map files used by mktexpk.
229 % See ftp://ftp.tug.org/tex/fontname.tar.gz.
230 TEXFONTMAPS = .;$TEXMF/fontname
232 % BibTeX bibliographies and style files.
233 BIBINPUTS = .;$TEXMF/bibtex/{bib,}//
234 BSTINPUTS = .;$TEXMF/bibtex/{bst,}//
236 % MFT style files.
237 MFTINPUTS = .;$TEXMF/mft//
239 % PostScript headers, prologues (.pro), encodings (.enc) and fonts.
240 TEXPSHEADERS = .;$TEXMF/{dvips,pdftex,tex,fonts/type1}//
242 % PostScript Type 1 outline fonts.
243 T1FONTS = .;$TEXMF/fonts/type1//
245 % PostScript AFM metric files.
246 AFMFONTS = .;$TEXMF/fonts/afm//
248 % TrueType outline fonts.
249 TTFONTS = .;$TEXMF/fonts/truetype//
251 % Type 42 outline fonts.
252 T42FONTS = .;$TEXMF/fonts/type42//
254 % Dvips' config.* files (this name should not start with `TEX'!).
255 TEXCONFIG = .;$TEXMF/dvips//
257 % Makeindex style (.ist) files.
258 INDEXSTYLE = .;$TEXMF/makeindex//
260 % Used by DMP (ditroff-to-mpx), called by makempx -troff.
261 TRFONTS = /usr/lib/font/devpost
262 MPSUPPORT = .;$TEXMF/metapost/support
264 % For xdvi to find mime.types and .mailcap, if they do not exist in
265 % $HOME.  These are single directories, not paths.
266 % (But the default mime.types, at least, may well suffice.)
267 MIMELIBDIR = $SELFAUTOPARENT/etc
268 MAILCAPLIBDIR = $SELFAUTOPARENT/etc
270 % TeX documentation and source files, for use with kpsewhich.
271 TEXDOCS = .;$TEXMF/doc//
272 TEXSOURCES = .;$TEXMF/source//
274 % Omega-related fonts and other files.  The odd construction for OFMFONTS
275 % makes it behave in the face of a definition of TFMFONTS.  Unfortunately
276 % no default substitution would take place for TFMFONTS, so an explicit
277 % path is retained.
278 OFMFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/{ofm,tfm}//;$TFMFONTS
279 OPLFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/opl//
280 OVFFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/ovf//
281 OVPFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/ovp//
282 OTPINPUTS = .;$TEXMF/omega/otp//
283 OCPINPUTS = .;$TEXMF/omega/ocp//
285 % Some additional input variables for several programs.  If you add
286 % a program that uses the 'other text files' or 'other binary files'
287 % search formats, you'll want to add their variables here as well.
288 T4HTINPUTS   = .;$TEXMF/tex4ht//
290 %% The mktex* scripts rely on KPSE_DOT. Do not set it in the environment.
291 KPSE_DOT = .
293 % This definition isn't used from this .cnf file itself (that would be
294 % paradoxical), but the compile-time default in paths.h is built from it.
295 % The SELFAUTO* variables are set automatically from the location of
296 % argv[0], in kpse_set_progname.  
298 % The TETEXDIR stuff isn't likely to relevant unless you're using teTeX,
299 % but it doesn't hurt.
301 % For security reasons, it is better not to have . part of the path.
303 TEXMFCNF = {$SELFAUTOLOC,$SELFAUTODIR,$SELFAUTOPARENT}{,{/share,}/texmf{.local,}/web2c}:$TETEXDIR:/usr/local/teTeX/share/texmf/web2c:/usr/local/teTeX/share/texmf/web2c
307 \f Part 2: Non-path options.
309 % Write .log/.dvi/etc. files here, if the current directory is unwritable.
310 % TEXMFOUTPUT = /tmp
312 % If a dynamic file creation fails, log the command to this file, in
313 % either the current directory or TEXMFOUTPUT.  Set to the
314 % empty string or  0  to avoid logging.
315 MISSFONT_LOG = missfont.log
317 % Set to a colon-separated list of words specifying warnings to suppress.
318 % To suppress everything, use TEX_HUSH = all; this is equivalent to
319 % TEX_HUSH = checksum:lostchar:readable:special
320 TEX_HUSH = none
322 % Enable system commands via \write18{...}?
323 shell_escape = f
325 % Allow TeX \openin, \openout, or \input on filenames starting with `.'
326 % (e.g., .rhosts) or outside the current tree (e.g., /etc/passwd)?
327 % a (any)        : any file can be opened.
328 % r (restricted) : disallow opening "dotfiles".
329 % p (paranoid)   : as 'r' and disallow going to parent directories, and
330 %                  restrict absolute paths to be under $TEXMFOUTPUT.
331 openout_any = p
332 openin_any = a
334 % Allow TeX, MF, and MP to parse the first line of an input file for
335 % the %&format construct.
336 parse_first_line = t
338 % Enable the mktex... scripts by default?  These must be set to 0 or 1.
339 % Particular programs can and do override these settings, for example
340 % dvips's -M option.  Your first chance to specify whether the scripts
341 % are invoked by default is at configure time.
343 % These values are ignored if the script names are changed; e.g., if you
344 % set DVIPSMAKEPK to `foo', what counts is the value of the environment
345 % variable/config value `FOO', not the `MKTEXPK' value.
347 % MKTEXTEX = 0
348 % MKTEXPK = 0
349 % MKTEXMF = 0
350 % MKTEXTFM = 0
351 % MKOCP = 0
352 % MKOFM = 0
354 % What MetaPost runs to make MPX files.  This is passed an option -troff
355 % if MP is in troff mode.  Set to `0' to disable this feature.
356 MPXCOMMAND = makempx
359 \f Part 3: Array and other sizes for TeX (and Metafont and MetaPost).
361 % If you want to change some of these sizes only for a certain TeX
362 % variant, the usual dot notation works, e.g.,
363 % main_memory.hugetex = 20000000
365 % If a change here appears to be ignored, try redumping the format file.
367 % Memory. Must be less than 8,000,000 total.
369 % main_memory is relevant only to initex, extra_mem_* only to non-ini.
370 % Thus, have to redump the .fmt file after changing main_memory; to add
371 % to existing fmt files, increase extra_mem_*.  (To get an idea of how
372 % much, try \tracingstats=2 in your TeX source file;
373 % web2c/tests/memtest.tex might also be interesting.)
375 % To increase space for boxes (as might be needed by, e.g., PiCTeX),
376 % increase extra_mem_bot.
378 % For some xy-pic samples, you may need as much as 700000 words of memory.
379 % For the vast majority of documents, 60000 or less will do.
381 main_memory.context = 1500000
382 main_memory.mpost = 1000000
383 main_memory = 263000 % words of inimemory available; also applies to inimf&mp
384 extra_mem_top = 0    % extra high memory for chars, tokens, etc.
385 extra_mem_bot = 0    % extra low memory for boxes, glue, breakpoints, etc.
387 obj_tab_size.context = 256000
389 % Words of font info for TeX (total size of all TFM files, approximately). 
390 font_mem_size = 400000
392 % Total number of fonts. Must be >= 50 and <= 2000 (without tex.ch changes).
393 font_max = 1000
395 % Extra space for the hash table of control sequences (which allows 10K
396 % names as distributed).
397 hash_extra.context = 25000
398 hash_extra = 0
400 % Max number of characters in all strings, including all error messages,
401 % help texts, font names, control sequences.  These values apply to TeX and MP.
402 pool_size.context = 750000
403 pool_size = 750000              
404 % Minimum pool space after TeX/MP's own strings; must be at least
405 % 25000 less than pool_size, but doesn't need to be nearly that large.
406 string_vacancies.context = 45000
407 string_vacancies = 25000
408 % Maximum number of strings.
409 max_strings.context = 55000
410 max_strings = 15000
411 % min pool space left after loading .fmt
412 pool_free.context = 47500
413 pool_free = 5000
415 % Hyphenation trie. As distributed, the maximum is 65535; this should
416 % work unless `unsigned short' is not supported or is smaller than 16
417 % bits.  This value should suffice for UK English, US English, French,
418 % and German (for example).  To increase, you must change
419 % `ssup_trie_opcode' and `ssup_trie_size' in tex.ch (and rebuild TeX);
420 % the trie will then consume four bytes per entry, instead of two.
422 % US English, German, and Portuguese: 30000.
423 % German: 14000.
424 % US English: 10000.
426 trie_size = 64000
428 % Buffer size.  TeX uses the buffer to contain input lines, but macro
429 % expansion works by writing material into the buffer and reparsing the
430 % line.  As a consequence, certain constructs require the buffer to be
431 % very large.  As distributed, the size is 50000; most documents can be
432 % handled within a tenth of this size.
433 buf_size = 50000
435 hyph_size = 1000        % number of hyphenation exceptions, >610 and <32767.
436 nest_size.context = 500
437 nest_size = 100         % simultaneous semantic levels (e.g., groups)
438 max_in_open = 15        % simultaneous input files and error insertions
439 param_size.context = 1500
440 param_size = 500        % simultaneous macro parameters
441 save_size.context = 5000
442 save_size = 4000        % for saving values outside current group
443 stack_size.context = 1500
444 stack_size = 300        % simultaneous input sources
446 % These are Omega-specific.
447 ocp_buf_size = 20000    % character buffers for ocp filters.
448 ocp_stack_size = 10000  % stacks for ocp computations.
449 ocp_list_size = 1000    % control for multiple ocps.
451 % These work best if they are the same as the I/O buffer size, but it
452 % doesn't matter much.  Must be a multiple of 8.
453 dvi_buf_size = 16384 % TeX
454 gf_buf_size = 16384  % MF
456 % It's probably inadvisable to change these. At any rate, we must have:
457 % 45 < error_line      < 255;
458 % 30 < half_error_line < error_line - 15;
459 % 60 <= max_print_line;
460 % These apply to Metafont and MetaPost as well.
461 error_line = 79
462 half_error_line = 50
463 max_print_line = 79