tentative fix for issue 3 (ex 53)
[mplib] / src / texk / kpathsea / texmf.in
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 % In this file, either ; or : can be used to separate path components.
37 % A leading/trailing/doubled path separator in the paths will be
38 %   expanded into the compile-time default. Probably not what you want.
39 %
40 % You can use brace notation, for example: /usr/local/{mytex,othertex}
41 % expands to /usr/local/mytex:/usr/local/othertex.  Instead of the comma
42 % you can use the path separator: /usr/local/{mytex:othertex} also expands
43 % to /usr/local/mytex:/usr/local/othertex.
44
45\f Part 1: Search paths and directories.
46
47 % You can set an environment variable to override TEXMF if you're testing
48 % a new TeX tree, without changing anything else.
49 %
50 % You may wish to use one of the $SELFAUTO... variables here so TeX will
51 % find where to look dynamically.  See the manual and the definition
52 % below of TEXMFCNF.
53
54 % The tree containing the runtime files closely related to the specific
55 % program version used:
56 TEXMFMAIN = @texmf@
57
58 % The main distribution tree:
59 TEXMFDIST = @texmf@-dist
60
61 % A place for local additions to a "standard" texmf tree.
62 % This tree is not used for local configuration maintained by
63 % texconfig, it uses TEXMFCONFIG below.
64 TEXMFLOCAL = @texmf@-local
65
66 % TEXMFSYSVAR, where texconfig-sys stores variable runtime data.
67 % With teTeX-3.0 or later, this must be set.
68 % For sharing this tree with $TEXMFMAIN:
69 %   TEXMFSYSVAR = $TEXMFMAIN
70 % For using a separate tree:
71 %   TEXMFSYSVAR = $SELFAUTOPARENT/texmf-var
72 TEXMFSYSVAR = @texmf@-var
73
74 % TEXMFSYSCONFIG, where texconfig-sys stores configuration data.
75 % With teTeX-3.0 or later, this must be set.
76 % For sharing this tree with $TEXMFMAIN:
77 %   TEXMFSYSCONFIG = $TEXMFMAIN
78 % For using a separate tree:
79 %   TEXMFSYSCONFIG = $SELFAUTOPARENT/texmf-config
80 TEXMFSYSCONFIG = @texmf@-config
81
82 % User texmf trees are allowed as follows.
83 % This used to be HOMETEXMF.
84 TEXMFHOME = ~/texmf
85
86 % TEXMFVAR, where texconfig stores variable runtime data.
87 % With teTeX-3.0 or later, this must be set.
88 % For sharing this tree with $TEXMFMAIN:
89 %   TEXMFVAR = $TEXMFMAIN
90 % For using a separate tree:
91 %   TEXMFVAR = ~/.texmf-var  # teTeX 3.0 default
92 TEXMFVAR = ~/.texlive2007/texmf-var
93
94 % TEXMFCONFIG, where texconfig stores configuration data.
95 % With teTeX-3.0 or later, this must be set.
96 % For sharing this tree with $TEXMFMAIN:
97 %   TEXMFCONFIG = $TEXMFMAIN
98 % For using a separate tree:
99 %   TEXMFCONFIG = ~/.texmf-config  # teTeX 3.0 default
100 % For using a separate tree:
101 %   TEXMFCONFIG = $SELFAUTOPARENT/texmf-config
102 TEXMFCONFIG = ~/.texlive2007/texmf-config
103
104 % Now, list all the texmf trees. If you have multiple trees you can
105 % use shell brace notation, like this:
106 %   TEXMF = {$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFMAIN}
107 % The braces are necessary.
108 %
109 % For texconfig to work properly, TEXMFCONFIG and TEXMFVAR should be named
110 % explicitly and before all other trees.
111 TEXMF = {$TEXMFCONFIG,$TEXMFVAR,$TEXMFHOME,!!$TEXMFSYSCONFIG,!!$TEXMFSYSVAR,!!$TEXMFMAIN,!!$TEXMFLOCAL,!!$TEXMFDIST}
112
113 % The system trees.  These are the trees that are shared by all the users.
114 % If a tree appears in this list, the mktex* scripts will use
115 % VARTEXFONTS for generated files, if the original tree isn't writable;
116 % otherwise the current working directory is used.
117 SYSTEXMF = $TEXMFSYSVAR;$TEXMFLOCAL;$TEXMFMAIN;$TEXMFDIST
118
119 % Where generated fonts may be written.  This tree is used when the sources
120 % were found in a system tree and either that tree wasn't writable, or the
121 % varfonts feature was enabled in MT_FEATURES in mktex.cnf.
122 VARTEXFONTS = @vartexfonts@
123
124 % Where to look for ls-R files.  There need not be an ls-R in the
125 % directories in this path, but if there is one, Kpathsea will use it.
126 %
127 % By default, this is only the !! elements of TEXMF, so that mktexlsr
128 % does not create ls-R files in the non-!! elements -- because if an
129 % ls-R is present, it will be used, and the disk will not be searched.
130 % This is arguably a bug in kpathsea, but we will not think about it now.
131
132 TEXMFDBS = {!!$TEXMFSYSCONFIG,!!$TEXMFSYSVAR,!!$TEXMFMAIN,!!$TEXMFLOCAL,!!$TEXMFDIST}
133
134 % It may be convenient to define TEXMF like this:
135 %   TEXMF = {$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFMAIN,~}
136 % which allows users to set up entire texmf trees, and tells TeX to
137 % look in places like ~/tex and ~/bibtex.  If you do this, define TEXMFDBS
138 % like this:
139 %   TEXMFDBS = $TEXMFHOME;$TEXMFLOCAL;$TEXMFMAIN;$VARTEXFONTS
140 % or mktexlsr will generate an ls-R file for ~ when called, which is
141 % rarely desirable.  If you do this you'll want to define SYSTEXMF like
142 % this:
143 %   SYSTEXMF = $TEXMFLOCAL;$TEXMFMAIN;$TEXMFDIST
144 % so that fonts from a user's tree won't escape into the global trees.
145 %
146 % On some systems, there will be a system tree which contains all the font
147 % files that may be created as well as the formats.  For example
148 %   TEXMFVAR = /var/lib/texmf
149 % is used on many Linux systems.  In this case, set VARTEXFONTS like this
150 % VARTEXFONTS = $TEXMFVAR/fonts
151 % and do not mention it in TEXMFDBS (but _do_ mention TEXMFVAR).
152 %
153 % Remove $VARTEXFONTS from TEXMFDBS if the VARTEXFONTS directory is below
154 % one of the TEXMF directories (avoids overlapping ls-R files).
155
156
157 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
158 % Usually you will not need to edit any of the other variables in part 1. %
159 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
160
161 % WEB2C is for Web2C specific files.  The current directory may not be
162 % a good place to look for them.
163 WEB2C = $TEXMF/web2c
164
165 % TEXINPUTS is for TeX input files -- i.e., anything to be found by \input
166 % or \openin, including .sty, .eps, etc.
167
168 % Plain TeX.  Have the command tex check all directories as a last
169 % resort, we may have plain-compatible stuff anywhere.
170 TEXINPUTS.tex           = .;$TEXMF/tex/{plain,generic,}//
171
172 % Other plain-based formats.
173 TEXINPUTS.amstex        = .;$TEXMF/tex/{amstex,plain,generic,}//
174 TEXINPUTS.csplain       = .;$TEXMF/tex/{csplain,plain,generic,}//
175 TEXINPUTS.eplain        = .;$TEXMF/tex/{eplain,plain,generic,}//
176 TEXINPUTS.ftex          = .;$TEXMF/tex/{formate,plain,generic,}//
177 TEXINPUTS.jadetex       = .;$TEXMF/tex/{jadetex,plain,generic,}//
178 TEXINPUTS.mex           = .;$TEXMF/tex/{mex,plain,generic,}//
179 TEXINPUTS.texinfo       = .;$TEXMF/tex/{texinfo,plain,generic,}//
180
181 % LaTeX 2e specific macros are stored in latex/, macros that can only be
182 % used with 2.09 in latex209/.  In addition, we look in the directory
183 % latex209, useful for macros that were written for 2.09 and do not
184 % mention 2e at all, but can be used with 2e.
185 TEXINPUTS.cslatex       = .;$TEXMF/tex/{cslatex,csplain,latex,generic,}//
186 TEXINPUTS.latex         = .;$TEXMF/tex/{latex,generic,}//
187 TEXINPUTS.olatex        = .;$TEXMF/tex/{latex,generic,}//
188 TEXINPUTS.latex209      = .;$TEXMF/tex/{latex209,generic,latex,}//
189
190 % Fontinst needs to read afm files.
191 TEXINPUTS.fontinst      = .;$TEXMF/{tex,fonts/afm}//
192
193 % MLTeX.
194 TEXINPUTS.frlatex       = .;$TEXMF/tex/{french,latex,generic,}//
195 TEXINPUTS.frtex         = .;$TEXMF/tex/{french,plain,generic,}//
196 TEXINPUTS.mllatex       = .;$TEXMF/tex/{latex,generic,}//
197 TEXINPUTS.mltex         = .;$TEXMF/tex/{plain,generic,}//
198
199 % e-TeX.  This form of the input paths is borrowed from teTeX.  A certain
200 % variant of TDS is assumed here, unaffected by the build variables.
201 TEXINPUTS.elatex        = .;$TEXMF/tex/{latex,generic,}//
202 TEXINPUTS.etex          = .;$TEXMF/tex/{plain,generic,}//
203
204 % pdfTeX.  This form of the input paths is borrowed from teTeX.  A certain
205 % variant of TDS is assumed here, unaffected by the build variables.
206 TEXINPUTS.pdfcslatex    = .;$TEXMF/tex/{cslatex,csplain,latex,generic,}//
207 TEXINPUTS.pdfcsplain    = .;$TEXMF/tex/{csplain,plain,generic,}//
208 TEXINPUTS.pdfjadetex    = .;$TEXMF/tex/{jadetex,plain,generic,}//
209 TEXINPUTS.pdflatex      = .;$TEXMF/tex/{latex,generic,}//
210 TEXINPUTS.pdfmex        = .;$TEXMF/tex/{mex,plain,generic,}//
211 TEXINPUTS.utf8mex       = .;$TEXMF/tex/{mex,plain,generic,}//
212 TEXINPUTS.pdftex        = .;$TEXMF/tex/{plain,generic,}//
213 TEXINPUTS.pdftexinfo    = .;$TEXMF/tex/{texinfo,plain,generic,}//
214 TEXINPUTS.pdfamstex     = .;$TEXMF/tex/{amstex,plain,generic,}//
215
216 % pdfeTeX.
217 TEXINPUTS.pdfelatex     = .;$TEXMF/tex/{latex,generic,}//
218 TEXINPUTS.pdfetex       = .;$TEXMF/tex/{plain,generic,}//
219
220 % pdfxTeX.
221 TEXINPUTS.pdfxlatex     = .;$TEXMF/tex/{latex,generic,}//
222 TEXINPUTS.pdfxtex       = .;$TEXMF/tex/{plain,generic,}//
223
224 % XeTeX
225 TEXINPUTS.xelatex       = .;$TEXMF/tex/{xelatex,latex,generic,}//
226 TEXINPUTS.xeplain       = .;$TEXMF/tex/{xeplain,eplain,plain,generic,}//
227 TEXINPUTS.xetex         = .;$TEXMF/tex/{xetex,plain,generic,}//
228
229 % Omega / Aleph
230 TEXINPUTS.lamed         = .;$TEXMF/tex/{lamed,lambda,latex,generic,}//
231 TEXINPUTS.lambda        = .;$TEXMF/tex/{lambda,latex,generic,}//
232 TEXINPUTS.omega         = .;$TEXMF/tex/{plain,generic,}//
233 TEXINPUTS.aleph         = .;$TEXMF/tex/{plain,generic,}//
234
235 % ConTeXt
236 TEXINPUTS.context       = .;$TEXMF/tex/{context,plain,generic,}//
237
238 % odd formats needing their own paths
239 TEXINPUTS.lamstex       = .;$TEXMF/tex/{lamstex,plain,generic,}//
240 TEXINPUTS.lollipop      = .;$TEXMF/tex/{lollipop,plain,generic,}//
241
242 % Earlier entries override later ones, so put this last.
243 TEXINPUTS               = .;$TEXMF/tex/{$progname,generic,}//
244
245 % extra format definitions for TeX Live
246
247 TEXINPUTS.elambda       = .;$TEXMF/tex/{lambda,latex,generic,}//
248 TEXINPUTS.eomega        = .;$TEXMF/tex/{plain,generic,}//
249 TEXINPUTS.pdfxmex       = .;$TEXMF/tex/{mex,plain,generic,}//
250 TEXINPUTS.frpdflatex    = .;$TEXMF/tex/{french,latex,generic,}//
251 TEXINPUTS.frpdftex      = .;$TEXMF/tex/{french,plain,generic,}//
252 TEXINPUTS.xmltex        = .;$TEXMF/tex/{xmltex,latex,generic,}//
253 TEXINPUTS.pdfxmltex     = .;$TEXMF/tex/{xmltex,latex,generic,}//
254
255 TTF2TFMINPUTS =                 .;$TEXMF/ttf2pk//
256
257 % Metafont, MetaPost inputs.
258 MFINPUTS = .;$TEXMF/metafont//;{$TEXMF/fonts,$VARTEXFONTS}/source//
259 MPINPUTS = .;$TEXMF/metapost//
260
261 % allow for compressed files, and various extensions.
262 TEXDOCSSUFFIX   = ;.pdf;.ps;.dvi;.html;.txt;.tex
263 TEXDOCSCOMPRESS = ;.gz;.bz2;.zip;.Z
264 TEXDOCEXT       = {$TEXDOCSSUFFIX}{$TEXDOCSCOMPRESS}
265
266 % Dump files (fmt/base/mem) for vir{tex,mf,mp} to read (see
267 % web2c/INSTALL), and string pools (.pool) for ini{tex,mf,mp}.  It is
268 % painful that we have six paths and directories here (they all resolve
269 % to a single place by default), but historically ...
270 TEXFORMATS = .;$TEXMF/web2c{/$engine,}
271 MFBASES = .;$TEXMF/web2c{/$engine,}
272 MPMEMS = .;$TEXMF/web2c{/$engine,}
273 TEXPOOL = .;$TEXMF/web2c
274 MFPOOL = .;$TEXMF/web2c
275 MPPOOL = .;$TEXMF/web2c
276
277 % support the original xdvi.  Must come before the generic settings.
278 PKFONTS.XDvi   = .;$TEXMF/%s;$VARTEXFONTS/pk/{%m,modeless}//
279 VFFONTS.XDvi   = .;$TEXMF/%s
280 PSHEADERS.XDvi = .;$TEXMF/%q{dvips,fonts/type1}//
281 TEXPICTS.XDvi  = .;$TEXMF/%q{dvips,tex}//
282
283 % Device-independent font metric files.
284 VFFONTS = .;$TEXMF/fonts/vf//
285 TFMFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/tfm//
286
287 % The $MAKETEX_MODE below means the drivers will not use a cx font when
288 % the mode is ricoh.  If no mode is explicitly specified, kpse_prog_init
289 % sets MAKETEX_MODE to /, so all subdirectories are searched.  See the manual.
290 % The modeless part guarantees that bitmaps for PostScript fonts are found.
291 PKFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/pk/{$MAKETEX_MODE,modeless}//
292
293 % Similarly for the GF format, which only remains in existence because
294 % Metafont outputs it (and MF isn't going to change).
295 GFFONTS = .;$TEXMF/fonts/gf/$MAKETEX_MODE//
296
297 % A backup for PKFONTS and GFFONTS. Not used for anything.
298 GLYPHFONTS = .;$TEXMF/fonts
299
300 % A place to puth everything that doesn't fit the other font categories.
301 MISCFONTS = .;$TEXMF/fonts/misc//
302
303 % font name map files.  This isn't just fonts/map// because ConTeXt
304 % wants support for having files with the same name in the different
305 % subdirs.  Maybe if the programs ever get unified to accepting the same
306 % map file syntax the definition can be simplified again.
307 TEXFONTMAPS = .;$TEXMF/fonts/map/{$progname,pdftex,dvips,}//
308
309 % BibTeX bibliographies and style files.
310 BIBINPUTS = .;$TEXMF/bibtex/bib//
311 BSTINPUTS = .;$TEXMF/bibtex/{bst,csf}//
312 % For bibtex8. Do we really need to repeat the BIBINPUTS setting?
313 BIBINPUTS.bibtex8 =             .;$TEXMF/bibtex/{bib,}//
314 BSTINPUTS.bibtex8 =             .;$TEXMF/bibtex/{bst,csf,}//
315
316 % MFT style files.
317 MFTINPUTS = .;$TEXMF/mft//
318
319 % PostScript headers and prologues (.pro); unfortunately, some programs
320 % also use this for acessing font files (enc, type1, truetype)
321 TEXPSHEADERS = .;$TEXMF/{dvips,fonts/{enc,type1,type42,type3}}//
322 TEXPSHEADERS.gsftopk = .;$TEXMF/{dvips,fonts/{enc,type1,type42,type3,truetype}}//
323
324 % OSFONTDIR is to provide a convenient hook for allowing TeX to find
325 % fonts installed on the system (outside of TeX).  An empty default
326 % value would add "//" to the search paths, so we give it a dummy value.
327 OSFONTDIR = /please/set/osfontdir/in/the/environment
328
329 % PostScript Type 1 outline fonts.
330 T1FONTS = .;$TEXMF/fonts/type1//;$OSFONTDIR//
331
332 % PostScript AFM metric files.
333 AFMFONTS = .;$TEXMF/fonts/afm//;$OSFONTDIR//
334
335 % TrueType outline fonts.
336 TTFONTS = .;$TEXMF/fonts/truetype//;$OSFONTDIR//
337
338 % Opentype outline fonts.
339 OPENTYPEFONTS = .;$TEXMF/fonts/opentype//;$OSFONTDIR//
340
341 % Type 42 outline fonts.
342 T42FONTS = .;$TEXMF/fonts/type42//
343
344 % Ligature definition files.
345 LIGFONTS =  .;$TEXMF/fonts/lig//
346
347 % Dvips' config.* files (this name should not start with `TEX'!).
348 TEXCONFIG = $TEXMF/dvips//
349
350 % Makeindex style (.ist) files.
351 INDEXSTYLE = .;$TEXMF/makeindex//
352
353 % Font encoding files (.enc).
354 ENCFONTS = .;$TEXMF/fonts/enc//
355
356 % CMap files.
357 CMAPFONTS = .;$TEXMF/fonts/cmap//
358
359 % Subfont definition files.
360 SFDFONTS = .;$TEXMF/fonts/sfd//
361
362 % OpenType outline fonts.
363 OPENTYPEFONTS = .;$TEXMF/fonts/opentype//
364
365 % pdftex config files:
366 PDFTEXCONFIG = .;$TEXMF/pdftex/{$progname,}//
367
368 % Used by DMP (ditroff-to-mpx), called by makempx -troff.
369 TRFONTS = /usr{/local,}/share/groff/{current/font,site-font}/devps
370 MPSUPPORT = .;$TEXMF/metapost/support
371
372 % For xdvi to find mime.types and .mailcap, if they do not exist in
373 % ~.  These are single directories, not paths.
374 % (But the default mime.types, at least, may well suffice.)
375 MIMELIBDIR = @prefix@/etc
376 MAILCAPLIBDIR = @prefix@/etc
377
378 % Default settings for fontconfig library, used by Win32 versions of  
379 % xetex/xdvipdfmx (note that fontconfig on Linux/Unix-like systems 
380 % will ignore settings in this file)
381 FONTCONFIG_FILE=fonts.conf
382 FONTCONFIG_PATH=$SELFAUTOLOC/conf
383 FC_CACHEDIR=$SELFAUTOLOC/cache
384
385 % TeX documentation and source files, for use with kpsewhich.
386 % TeX Live has a separate hierarchy with just documentation, texmf-doc,
387 % in addition to the doc files in the other hierarchies.
388 TEXMFDOCDIR = $SELFAUTOPARENT/texmf-doc/doc
389 TEXDOCS = .;$TEXMF/doc//;$TEXMFDOCDIR//
390 TEXSOURCES = .;$TEXMF/source//
391
392 % Web and CWeb input paths.
393 WEBINPUTS = .;$TEXMF/web//
394 CWEBINPUTS = .;$TEXMF/cweb//
395
396 % Omega-related fonts and other files.
397 OFMFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/{ofm,tfm}//
398 OPLFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/opl//
399 OVFFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/{ovf,vf}//
400 OVPFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/ovp//
401 OTPINPUTS = .;$TEXMF/omega/otp//
402 OCPINPUTS = .;$TEXMF/omega/ocp//
403
404 % Some additional input variables for several programs.  If you add
405 % a program that uses the 'other text files' or 'other binary files'
406 % search formats, you'll want to add their variables here as well.
407 T4HTINPUTS   = .;$TEXMF/tex4ht//
408
409 %% t4ht utility, sharing files with TeX4ht
410 TEX4HTFONTSET=alias,iso8859,unicode
411 TEX4HTINPUTS = .;$TEXMF/tex4ht/base//;$TEXMF/tex4ht/ht-fonts/{$TEX4HTFONTSET}//
412
413 % Find scripts that are distributed/installed in the texmf tree.
414
415 % Lua needs to look in TEXINPUTS for lua scripts distributed with packages.
416 LUAINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/lua//;$TEXINPUTS
417
418 % Architecture independent executables.
419 TEXMFSCRIPTS = $TEXMF/scripts/{$engine,$progname,}//
420
421 % Other languages.
422 JAVAINPUTS   = .;$TEXMF/scripts/{$progname,$engine,}/java//
423 PERLINPUTS   = .;$TEXMF/scripts/{$progname,$engine,}/perl//
424 PYTHONINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/python//
425 RUBYINPUTS   = .;$TEXMF/scripts/{$progname,$engine,}/ruby//
426
427
428 %% The mktex* scripts rely on KPSE_DOT. Do not set it in the environment.
429 % KPSE_DOT = .
430
431 % This definition isn't used from this .cnf file itself (that would be
432 % paradoxical), but the compile-time default in paths.h is built from it.
433 % The SELFAUTO* variables are set automatically from the location of
434 % argv[0], in kpse_set_progname.
435
436 % The TETEXDIR stuff isn't likely to be relevant unless you're using
437 % teTeX, but it doesn't hurt.
438 %
439 % For security reasons, it is better not to have . part of the path.
440 %
441 TEXMFCNF = {$SELFAUTOLOC,$SELFAUTODIR,$SELFAUTOPARENT}{,{/share,}/texmf{-local,}/web2c};/.$TETEXDIR;$TEXMF/web2c;@web2c@
442
443 # kpathsea 3.5.3 and later sets these at runtime. To avoid empty
444 # expansions from binaries linked against an earlier version of the
445 # library, we set $progname and $engine to something non-empty:
446 progname = unsetprogname
447 engine = unsetengine
448
449
450\f Part 2: Non-path options.
451
452 % Write .log/.dvi/etc. files here, if the current directory is unwritable.
453 % TEXMFOUTPUT = /tmp
454
455 % If a dynamic file creation fails, log the command to this file, in
456 % either the current directory or TEXMFOUTPUT.  Set to the
457 % empty string or  0  to avoid logging.
458 MISSFONT_LOG = missfont.log
459
460 % Set to a colon-separated list of words specifying warnings to suppress.
461 % To suppress everything, use TEX_HUSH = all; this is currently equivalent to
462 % TEX_HUSH = checksum:lostchar:readable:special
463 % To suppress nothing, use TEX_HUSH = none or do not set the variable at all.
464 TEX_HUSH = none
465
466 % Enable system commands via \write18{...}?
467 shell_escape = f
468
469 % Allow TeX \openin, \openout, or \input on filenames starting with `.'
470 % (e.g., .rhosts) or outside the current tree (e.g., /etc/passwd)?
471 % a (any)        : any file can be opened.
472 % r (restricted) : disallow opening "dotfiles".
473 % p (paranoid)   : as 'r' and disallow going to parent directories, and
474 %                  restrict absolute paths to be under $TEXMFOUTPUT.
475 openout_any = p
476 openin_any = a
477
478 % Allow TeX, MF, and MP to parse the first line of an input file for
479 % the %&format construct.
480 parse_first_line = t
481
482 % But don't parse the first line if invoked as "tex", since we want that
483 % to remain Knuth-compatible.  The src_specials and
484 % file_line_error_style settings, as well as the options -enctex,
485 % -mltex, -8bit, etc., also affect this, but they are all off by default.
486 parse_first_line.tex = f
487
488 % Control file:line:error style messages.
489 file_line_error_style = f
490
491 % Enable the mktex... scripts by default?  These must be set to 0 or 1.
492 % Particular programs can and do override these settings, for example
493 % dvips's -M option.  Your first chance to specify whether the scripts
494 % are invoked by default is at configure time.
495 %
496 % These values are ignored if the script names are changed; e.g., if you
497 % set DVIPSMAKEPK to `foo', what counts is the value of the environment
498 % variable/config value `FOO', not the `MKTEXPK' value.
499 %
500 % MKTEXTEX = 0
501 % MKTEXPK = 0
502 % MKTEXMF = 0
503 % MKTEXTFM = 0
504 % MKTEXFMT = 0
505 % MKOCP = 0
506 % MKOFM = 0
507
508 % What MetaPost runs to make MPX files.  This is passed an option -troff
509 % if MP is in troff mode.  Set to `0' to disable this feature.
510 MPXCOMMAND = makempx
511
512 % Used by makempx to run TeX.  We use "etex" because MetaPost is
513 % expecting DVI, and not "tex" because we want first line parsing.
514 TEX = etex
515
516
517\f Part 3: Array and other sizes for TeX (and Metafont and MetaPost).
518 %
519 % If you want to change some of these sizes only for a certain TeX
520 % variant, the usual dot notation works, e.g.,
521 % main_memory.hugetex = 20000000
522 %
523 % If a change here appears to be ignored, try redumping the format file.
524
525 % Memory. Must be less than 8,000,000 total.
526 %
527 % main_memory is relevant only to initex, extra_mem_* only to non-ini.
528 % Thus, have to redump the .fmt file after changing main_memory; to add
529 % to existing fmt files, increase extra_mem_*.  (To get an idea of how
530 % much, try \tracingstats=2 in your TeX source file;
531 % web2c/tests/memtest.tex might also be interesting.)
532 %
533 % To increase space for boxes (as might be needed by, e.g., PiCTeX),
534 % increase extra_mem_bot.
535 %
536 % For some xy-pic samples, you may need as much as 700000 words of memory.
537 % For the vast majority of documents, 60000 or less will do.
538 %
539 main_memory = 3000000 % words of inimemory available; also applies to inimf&mp
540 extra_mem_top = 0     % extra high memory for chars, tokens, etc.
541 extra_mem_bot = 0     % extra low memory for boxes, glue, breakpoints, etc.
542
543 % ConTeXt needs lots of memory.
544 extra_mem_top.context = 2000000
545 extra_mem_bot.context = 4000000
546
547 % Words of font info for TeX (total size of all TFM files, approximately).
548 % Must be >= 20000 and <= 4000000 (without tex.ch changes).
549 font_mem_size = 2500000
550
551 % Total number of fonts. Must be >= 50 and <= 2000 (without tex.ch changes).
552 font_max = 2000
553
554 % Extra space for the hash table of control sequences (which allows 10K
555 % names as distributed).
556 hash_extra = 50000
557
558 % Max number of characters in all strings, including all error messages,
559 % help texts, font names, control sequences.  These values apply to TeX and MP.
560 pool_size = 1250000
561 % Minimum pool space after TeX/MP's own strings; must be at least
562 % 25000 less than pool_size, but doesn't need to be nearly that large.
563 string_vacancies = 90000
564 % Maximum number of strings.
565 max_strings = 100000
566 % min pool space left after loading .fmt
567 pool_free = 47500
568
569 % Buffer size.  TeX uses the buffer to contain input lines, but macro
570 % expansion works by writing material into the buffer and reparsing the
571 % line.  As a consequence, certain constructs require the buffer to be
572 % very large, even though most documents can be handled with a small value.
573 buf_size = 200000
574
575 % Hyphenation trie.  The maximum possible is 4194303 (ssup_trie_size in
576 % the sources), but we don't need that much.  The value here suffices
577 % for all known free hyphenation patterns to be loaded simultaneously
578 % (as TeX Live does).
579 %
580 trie_size = 400000
581
582 hyph_size = 8191        % prime number of hyphenation exceptions, >610, <32767.
583                         % http://primes.utm.edu/curios/page.php/8191.html
584 nest_size = 500         % simultaneous semantic levels (e.g., groups)
585 max_in_open = 15        % simultaneous input files and error insertions
586 param_size = 10000      % simultaneous macro parameters
587 save_size = 50000       % for saving values outside current group
588 stack_size = 5000       % simultaneous input sources
589
590 % These are Omega-specific.
591 ocp_buf_size = 500000   % character buffers for ocp filters.
592 ocp_stack_size = 10000  % stacks for ocp computations.
593 ocp_list_size = 1000    % control for multiple ocps.
594
595 % Parameter specific to MetaPost.
596 % Maximum number of knots between breakpoints of a path.
597 % Set to 2000 by default.
598 % path_size.mpost = 10000
599
600 % These work best if they are the same as the I/O buffer size, but it
601 % doesn't matter much.  Must be a multiple of 8.
602 dvi_buf_size = 16384 % TeX
603 gf_buf_size = 16384  % MF
604
605 % It's probably inadvisable to change these. At any rate, we must have:
606 % 45 < error_line      < 255;
607 % 30 < half_error_line < error_line - 15;
608 % 60 <= max_print_line;
609 % These apply to Metafont and MetaPost as well.
610 error_line = 79
611 half_error_line = 50
612 max_print_line = 79