1 % original texmf.cnf -- runtime path configuration file for kpathsea.
4 % What follows is a super-summary of what this .cnf file can
5 % contain. Please read the Kpathsea manual for more information.
7 % Any identifier (sticking to A-Za-z_ for names is safest) can be assigned.
8 % The `=' (and surrounding spaces) is optional.
9 % $foo (or ${foo}) in a value expands to the envvar or cnf value of foo.
11 % Earlier entries (in the same or another file) override later ones, and
12 % an environment variable foo overrides any texmf.cnf definition of foo.
14 % All definitions are read before anything is expanded, so you can use
15 % variables before they are defined.
17 % If a variable assignment is qualified with `.PROGRAM', it is ignored
18 % unless the current executable (last filename component of argv[0]) is
19 % named PROGRAM. This foo.PROGRAM construct is not recognized on the
20 % right-hand side. For environment variables, use FOO_PROGRAM.
22 % Which file formats use which paths for searches is described in the
23 % various programs' and the kpathsea documentation.
25 % // means to search subdirectories (recursively).
26 % A leading !! means to look only in the ls-R db, never on the disk.
27 % In this file, either ; or : can be used to separate path components.
28 % A leading/trailing/doubled path separator in the paths will be
29 % expanded into the compile-time default. Probably not what you want.
31 % You can use brace notation, for example: /usr/local/{mytex,othertex}
32 % expands to /usr/local/mytex:/usr/local/othertex. Instead of the comma
33 % you can use the path separator: /usr/local/{mytex:othertex} also expands
34 % to /usr/local/mytex:/usr/local/othertex.
36 %
\f Part 1: Search paths and directories.
38 % You can set an environment variable to override TEXMF if you're testing
39 % a new TeX tree, without changing anything else.
41 % You may wish to use one of the $SELFAUTO... variables here so TeX will
42 % find where to look dynamically. See the manual and the definition
45 % The tree containing the runtime files closely related to the specific
46 % program version used:
47 TEXMFMAIN = $SELFAUTOPARENT/texmf
49 % The main distribution tree:
50 TEXMFDIST = $SELFAUTOPARENT/texmf-dist
52 % Our documentation-only tree, arranged by language:
53 TEXMFDOC = $SELFAUTOPARENT/texmf-doc
55 % A place for local additions to a "standard" texmf tree.
56 % This tree is not used for local configuration maintained by
57 % texconfig, it uses TEXMFCONFIG below.
58 TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
60 % TEXMFSYSVAR, where texconfig-sys stores variable runtime data.
61 % With teTeX-3.0 or later, this must be set.
62 % For sharing this tree with $TEXMFMAIN:
63 % TEXMFSYSVAR = $TEXMFMAIN
64 % For using a separate tree:
65 % TEXMFSYSVAR = $SELFAUTOPARENT/texmf-var
66 TEXMFSYSVAR = $SELFAUTOPARENT/texmf-var
68 % TEXMFSYSCONFIG, where texconfig-sys stores configuration data.
69 % With teTeX-3.0 or later, this must be set.
70 % For sharing this tree with $TEXMFMAIN:
71 % TEXMFSYSCONFIG = $TEXMFMAIN
72 % For using a separate tree:
73 % TEXMFSYSCONFIG = $SELFAUTOPARENT/texmf-config
74 TEXMFSYSCONFIG = $SELFAUTOPARENT/texmf-config
76 % User texmf trees are allowed as follows.
77 % This used to be HOMETEXMF.
80 % TEXMFVAR, where texconfig stores variable runtime data.
81 % With teTeX-3.0 or later, this must be set.
82 % For sharing this tree with $TEXMFMAIN:
83 % TEXMFVAR = $TEXMFMAIN
84 % For using a separate tree:
85 % TEXMFVAR = ~/.texmf-var # teTeX 3.0 default
86 TEXMFVAR = ~/.texlive2008/texmf-var
88 % TEXMFCONFIG, where texconfig stores configuration data.
89 % With teTeX-3.0 or later, this must be set.
90 % For sharing this tree with $TEXMFMAIN:
91 % TEXMFCONFIG = $TEXMFMAIN
92 % For using a separate tree:
93 % TEXMFCONFIG = ~/.texmf-config # teTeX 3.0 default
94 % For using a separate tree:
95 % TEXMFCONFIG = $SELFAUTOPARENT/texmf-config
96 TEXMFCONFIG = ~/.texlive2008/texmf-config
98 % Now, list all the texmf trees. If you have multiple trees you can
99 % use shell brace notation, like this:
100 % TEXMF = {$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFMAIN}
101 % The braces are necessary.
103 % For texconfig to work properly, TEXMFCONFIG and TEXMFVAR should be named
104 % explicitly and before all other trees.
105 TEXMF = {$TEXMFCONFIG,$TEXMFVAR,$TEXMFHOME,!!$TEXMFSYSCONFIG,!!$TEXMFSYSVAR,!!$TEXMFMAIN,!!$TEXMFLOCAL,!!$TEXMFDIST}
107 % The system trees. These are the trees that are shared by all the users.
108 % If a tree appears in this list, the mktex* scripts will use
109 % VARTEXFONTS for generated files, if the original tree isn't writable;
110 % otherwise the current working directory is used.
111 SYSTEXMF = $TEXMFSYSVAR;$TEXMFMAIN;$TEXMFLOCAL;$TEXMFDIST
113 % Where generated fonts may be written. This tree is used when the sources
114 % were found in a system tree and either that tree wasn't writable, or the
115 % varfonts feature was enabled in MT_FEATURES in mktex.cnf.
116 VARTEXFONTS = $TEXMFVAR/fonts
118 % Where to look for ls-R files. There need not be an ls-R in the
119 % directories in this path, but if there is one, Kpathsea will use it.
120 % By default, this is only the !! elements of TEXMF, plus texmf-doc, so
121 % that mktexlsr does not create ls-R files in the non-!! elements --
122 % because if an ls-R is present, it will be used, and the disk will not
123 % be searched. This is arguably a bug in kpathsea, but we will not
124 % think about it now.
126 TEXMFDBS = {!!$TEXMFSYSCONFIG,!!$TEXMFSYSVAR,!!$TEXMFMAIN,!!$TEXMFLOCAL,!!$TEXMFDIST,!!$TEXMFDOC}
128 % On some systems, there will be a system tree which contains all the font
129 % files that may be created as well as the formats. For example
130 % TEXMFVAR = /var/lib/texmf
131 % is used on many Linux systems. In this case, set VARTEXFONTS like this
132 % VARTEXFONTS = $TEXMFVAR/fonts
133 % and do not mention it in TEXMFDBS (but _do_ mention TEXMFVAR).
135 % Remove $VARTEXFONTS from TEXMFDBS if the VARTEXFONTS directory is below
136 % one of the TEXMF directories (avoids overlapping ls-R files).
139 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
140 % Usually you will not need to edit any of the other variables in part 1. %
141 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
143 % WEB2C is for Web2C specific files. The current directory may not be
144 % a good place to look for them.
147 % TEXINPUTS is for TeX input files -- i.e., anything to be found by \input
148 % or \openin, including .sty, .eps, etc.
150 % Plain TeX. Have the command tex check all directories as a last
151 % resort, we may have plain-compatible stuff anywhere.
152 TEXINPUTS.tex = .;$TEXMF/tex/{plain,generic,}//
154 % Other plain-based formats.
155 TEXINPUTS.amstex = .;$TEXMF/tex/{amstex,plain,generic,}//
156 TEXINPUTS.csplain = .;$TEXMF/tex/{csplain,plain,generic,}//
157 TEXINPUTS.eplain = .;$TEXMF/tex/{eplain,plain,generic,}//
158 TEXINPUTS.ftex = .;$TEXMF/tex/{formate,plain,generic,}//
159 TEXINPUTS.jadetex = .;$TEXMF/tex/{jadetex,plain,generic,}//
160 TEXINPUTS.mex = .;$TEXMF/tex/{mex,plain,generic,}//
161 TEXINPUTS.texinfo = .;$TEXMF/tex/{texinfo,plain,generic,}//
162 TEXINPUTS.xetex = .;$TEXMF/tex/{xetex,plain,generic,}//
164 % LaTeX 2e specific macros are stored in latex/, macros that can only be
165 % used with 2.09 in latex209/. In addition, we look in the directory
166 % latex209, useful for macros that were written for 2.09 and do not
167 % mention 2e at all, but can be used with 2e.
168 TEXINPUTS.cslatex = .;$TEXMF/tex/{cslatex,csplain,latex,generic,}//
169 TEXINPUTS.latex = .;$TEXMF/tex/{latex,generic,}//
170 TEXINPUTS.olatex = .;$TEXMF/tex/{latex,generic,}//
171 TEXINPUTS.latex209 = .;$TEXMF/tex/{latex209,generic,latex,}//
172 TEXINPUTS.xelatex = .;$TEXMF/tex/{xelatex,latex,generic,}//
174 % Fontinst needs to read afm files.
175 TEXINPUTS.fontinst = .;$TEXMF/{tex,fonts/afm}//
178 TEXINPUTS.frlatex = .;$TEXMF/tex/{french,latex,generic,}//
179 TEXINPUTS.frtex = .;$TEXMF/tex/{french,plain,generic,}//
180 TEXINPUTS.mllatex = .;$TEXMF/tex/{latex,generic,}//
181 TEXINPUTS.mltex = .;$TEXMF/tex/{plain,generic,}//
183 % e-TeX. This form of the input paths is borrowed from teTeX. A certain
184 % variant of TDS is assumed here, unaffected by the build variables.
185 TEXINPUTS.elatex = .;$TEXMF/tex/{latex,generic,}//
186 TEXINPUTS.etex = .;$TEXMF/tex/{plain,generic,}//
188 % pdfTeX. This form of the input paths is borrowed from teTeX. A certain
189 % variant of TDS is assumed here, unaffected by the build variables.
190 TEXINPUTS.pdfcslatex = .;$TEXMF/tex/{cslatex,csplain,latex,generic,}//
191 TEXINPUTS.pdfcsplain = .;$TEXMF/tex/{csplain,plain,generic,}//
192 TEXINPUTS.pdfjadetex = .;$TEXMF/tex/{jadetex,plain,generic,}//
193 TEXINPUTS.pdflatex = .;$TEXMF/tex/{latex,generic,}//
194 TEXINPUTS.pdfmex = .;$TEXMF/tex/{mex,plain,generic,}//
195 TEXINPUTS.utf8mex = .;$TEXMF/tex/{mex,plain,generic,}//
196 TEXINPUTS.pdftex = .;$TEXMF/tex/{plain,generic,}//
197 TEXINPUTS.pdftexinfo = .;$TEXMF/tex/{texinfo,plain,generic,}//
198 TEXINPUTS.pdfamstex = .;$TEXMF/tex/{amstex,plain,generic,}//
201 TEXINPUTS.pdfelatex = .;$TEXMF/tex/{latex,generic,}//
202 TEXINPUTS.pdfetex = .;$TEXMF/tex/{plain,generic,}//
205 TEXINPUTS.pdfxlatex = .;$TEXMF/tex/{latex,generic,}//
206 TEXINPUTS.pdfxtex = .;$TEXMF/tex/{plain,generic,}//
209 TEXINPUTS.xelatex = .;$TEXMF/tex/{xelatex,latex,generic,}//
210 TEXINPUTS.xeplain = .;$TEXMF/tex/{xeplain,eplain,plain,generic,}//
211 TEXINPUTS.xetex = .;$TEXMF/tex/{xetex,plain,generic,}//
214 TEXINPUTS.lamed = .;$TEXMF/tex/{lamed,lambda,latex,generic,}//
215 TEXINPUTS.lambda = .;$TEXMF/tex/{lambda,latex,generic,}//
216 TEXINPUTS.omega = .;$TEXMF/tex/{plain,generic,}//
217 TEXINPUTS.aleph = .;$TEXMF/tex/{plain,generic,}//
220 TEXINPUTS.context = .;$TEXMF/tex/{context,plain,generic,}//
222 % odd formats needing their own paths
223 TEXINPUTS.lamstex = .;$TEXMF/tex/{lamstex,plain,generic,}//
224 TEXINPUTS.lollipop = .;$TEXMF/tex/{lollipop,plain,generic,}//
226 % Earlier entries override later ones, so put this last.
227 TEXINPUTS = .;$TEXMF/tex/{$progname,generic,}//
229 % extra format definitions for TeX Live
231 TEXINPUTS.elambda = .;$TEXMF/tex/{lambda,latex,generic,}//
232 TEXINPUTS.eomega = .;$TEXMF/tex/{plain,generic,}//
233 TEXINPUTS.pdfxmex = .;$TEXMF/tex/{mex,plain,generic,}//
234 TEXINPUTS.frpdflatex = .;$TEXMF/tex/{french,latex,generic,}//
235 TEXINPUTS.frpdftex = .;$TEXMF/tex/{french,plain,generic,}//
236 TEXINPUTS.xmltex = .;$TEXMF/tex/{xmltex,latex,generic,}//
237 TEXINPUTS.pdfxmltex = .;$TEXMF/tex/{xmltex,latex,generic,}//
239 TTF2TFMINPUTS = .;$TEXMF/ttf2pk//
241 % Metafont, MetaPost inputs.
242 MFINPUTS = .;$TEXMF/metafont//;{$TEXMF/fonts,$VARTEXFONTS}/source//
243 MPINPUTS = .;$TEXMF/metapost//
245 % allow for compressed files, and various extensions.
246 TEXDOCSSUFFIX = ;.pdf;.ps;.dvi;.html;.txt;.tex
247 TEXDOCSCOMPRESS = ;.gz;.bz2;.zip;.Z
248 TEXDOCEXT = {$TEXDOCSSUFFIX}{$TEXDOCSCOMPRESS}
250 % Dump files (fmt/base/mem) for vir{tex,mf,mp} to read.
251 % We want to find the engine-specific file, e.g., cont-en.fmt can
252 % exist under both pdftex/ and xetex/. But just in case some formats
253 % end up without an engine directory, look directly in web2c/ too.
254 TEXFORMATS = .;$TEXMF/web2c{/$engine,}
255 MFBASES = ${TEXFORMATS}
256 MPMEMS = ${TEXFORMATS}
258 % As of 2008, pool files don't exist any more (the strings are compiled
259 % into the binaries), but just in case something expects to find these
261 TEXPOOL = .;$TEXMF/web2c
265 % support the original xdvi. Must come before the generic settings.
266 PKFONTS.XDvi = .;$TEXMF/%s;$VARTEXFONTS/pk/{%m,modeless}//
267 VFFONTS.XDvi = .;$TEXMF/%s
268 PSHEADERS.XDvi = .;$TEXMF/%q{dvips,fonts/type1}//
269 TEXPICTS.XDvi = .;$TEXMF/%q{dvips,tex}//
271 % Device-independent font metric files.
272 VFFONTS = .;$TEXMF/fonts/vf//
273 TFMFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/tfm//
275 % The $MAKETEX_MODE below means the drivers will not use a cx font when
276 % the mode is ricoh. If no mode is explicitly specified, kpse_prog_init
277 % sets MAKETEX_MODE to /, so all subdirectories are searched. See the manual.
278 % The modeless part guarantees that bitmaps for PostScript fonts are found.
279 PKFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/pk/{$MAKETEX_MODE,modeless}//
281 % Similarly for the GF format, which only remains in existence because
282 % Metafont outputs it (and MF isn't going to change).
283 GFFONTS = .;$TEXMF/fonts/gf/$MAKETEX_MODE//
285 % A backup for PKFONTS and GFFONTS. Not used for anything.
286 GLYPHFONTS = .;$TEXMF/fonts
288 % A place to puth everything that doesn't fit the other font categories.
289 MISCFONTS = .;$TEXMF/fonts/misc//
291 % font name map files. This isn't just fonts/map// because ConTeXt
292 % wants support for having files with the same name in the different
293 % subdirs. Maybe if the programs ever get unified to accepting the same
294 % map file syntax the definition can be simplified again.
295 TEXFONTMAPS = .;$TEXMF/fonts/map/{$progname,pdftex,dvips,}//
297 % BibTeX bibliographies and style files.
298 BIBINPUTS = .;$TEXMF/bibtex/bib//
299 BSTINPUTS = .;$TEXMF/bibtex/{bst,csf}//
300 % For bibtex8. Do we really need to repeat the BIBINPUTS setting?
301 BIBINPUTS.bibtex8 = .;$TEXMF/bibtex/{bib,}//
302 BSTINPUTS.bibtex8 = .;$TEXMF/bibtex/{bst,csf,}//
305 MFTINPUTS = .;$TEXMF/mft//
307 % PostScript headers and prologues (.pro); unfortunately, some programs
308 % also use this for acessing font files (enc, type1, truetype)
309 TEXPSHEADERS = .;$TEXMF/{dvips,fonts/{enc,type1,type42,type3}}//
310 TEXPSHEADERS.gsftopk = .;$TEXMF/{dvips,fonts/{enc,type1,type42,type3,truetype}}//
312 % OSFONTDIR is to provide a convenient hook for allowing TeX to find
313 % fonts installed on the system (outside of TeX). An empty default
314 % value would add "//" to the search paths, so we give it a dummy value.
315 OSFONTDIR = /please/set/osfontdir/in/the/environment
317 % PostScript Type 1 outline fonts.
318 T1FONTS = .;$TEXMF/fonts/type1//;$OSFONTDIR//
320 % PostScript AFM metric files.
321 AFMFONTS = .;$TEXMF/fonts/afm//;$OSFONTDIR//
323 % TrueType outline fonts.
324 TTFONTS = .;$TEXMF/fonts/truetype//;$OSFONTDIR//
326 % Opentype outline fonts.
327 OPENTYPEFONTS = .;$TEXMF/fonts/opentype//;$OSFONTDIR//
329 % Type 42 outline fonts.
330 T42FONTS = .;$TEXMF/fonts/type42//
332 % Ligature definition files.
333 LIGFONTS = .;$TEXMF/fonts/lig//
335 % Dvips' config.* files (this name should not start with `TEX'!).
336 TEXCONFIG = $TEXMF/dvips//
338 % Makeindex style (.ist) files.
339 INDEXSTYLE = .;$TEXMF/makeindex//
341 % Font encoding files (.enc).
342 ENCFONTS = .;$TEXMF/fonts/enc//
345 CMAPFONTS = .;$TEXMF/fonts/cmap//
347 % Subfont definition files.
348 SFDFONTS = .;$TEXMF/fonts/sfd//
350 % OpenType outline fonts.
351 OPENTYPEFONTS = .;$TEXMF/fonts/opentype//
353 % pdftex config files:
354 PDFTEXCONFIG = .;$TEXMF/pdftex/{$progname,}//
356 % Used by DMP (ditroff-to-mpx), called by makempx -troff.
357 TRFONTS = /usr{/local,}/share/groff/{current/font,site-font}/devps
358 MPSUPPORT = .;$TEXMF/metapost/support
360 % For xdvi to find mime.types and .mailcap, if they do not exist in
361 % ~. These are single directories, not paths.
362 % (But the default mime.types, at least, may well suffice.)
363 MIMELIBDIR = $SELFAUTOPARENT/etc
364 MAILCAPLIBDIR = $SELFAUTOPARENT/etc
366 % Default settings for fontconfig library, used by Win32 versions of
367 % xetex/xdvipdfmx (note that fontconfig on Linux/Unix-like systems
368 % will ignore settings in this file)
369 FONTCONFIG_FILE=fonts.conf
370 FONTCONFIG_PATH=$TEXMFSYSVAR/fonts/conf
371 FC_CACHEDIR=$TEXMFSYSVAR/fonts/cache
373 % TeX documentation and source files, for use with kpsewhich.
374 % TeX Live has a separate hierarchy with just documentation, texmf-doc,
375 % in addition to the doc files in the other hierarchies.
376 % Also, find the English documentation first -- better than random, when
377 % there are name collisions.
378 TEXMFDOCDIR = $TEXMFDOC/doc{/english,}
379 TEXDOCS = .;$TEXMF/doc//;$TEXMFDOCDIR//
380 TEXSOURCES = .;$TEXMF/source//
382 % Web and CWeb input paths.
383 WEBINPUTS = .;$TEXMF/web//
384 CWEBINPUTS = .;$TEXMF/cweb//
386 % Omega-related fonts and other files.
387 OFMFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/{ofm,tfm}//
388 OPLFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/opl//
389 OVFFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/{ovf,vf}//
390 OVPFONTS = .;{$TEXMF/fonts,$VARTEXFONTS}/ovp//
391 OTPINPUTS = .;$TEXMF/omega/otp//
392 OCPINPUTS = .;$TEXMF/omega/ocp//
394 % Some additional input variables for several programs. If you add
395 % a program that uses the `other text files' or `other binary files'
396 % search formats, you'll want to add their variables here as well.
397 T4HTINPUTS = .;$TEXMF/tex4ht//
399 %% t4ht utility, sharing files with TeX4ht
400 TEX4HTFONTSET=alias,iso8859,unicode
401 TEX4HTINPUTS = .;$TEXMF/tex4ht/base//;$TEXMF/tex4ht/ht-fonts/{$TEX4HTFONTSET}//
403 % Find scripts that are distributed/installed in the texmf tree.
405 % Lua needs to look in TEXINPUTS for lua scripts distributed with packages.
406 LUAINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/lua//;$TEXINPUTS
408 % Architecture independent executables.
409 TEXMFSCRIPTS = $TEXMF/scripts/{$engine,$progname,}//
412 JAVAINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/java//
413 PERLINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/perl//
414 PYTHONINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/python//
415 RUBYINPUTS = .;$TEXMF/scripts/{$progname,$engine,}/ruby//
418 %% The mktex* scripts rely on KPSE_DOT. Do not set it in the environment.
421 % This definition isn't used from this .cnf file itself (that would be
422 % paradoxical), but the compile-time default in paths.h is built from it.
423 % The SELFAUTO* variables are set automatically from the location of
424 % argv[0], in kpse_set_program_name.
426 % This main texmf.cnf file is installed, for a release YYYY, in a
427 % directory such as /usr/local/texlive/YYYY/texmf/web2c/texmf.cnf.
428 % Since this file is subject to future updates, the TeX Live installer
429 % or human administrator may also create a file
430 % /usr/local/texlive/YYYY/texmf.cnf; any settings in this latter file
431 % will take precedence over the distributed one under texmf/web2c.
433 % For security reasons, it is better not to include . in this path.
435 TEXMFCNF = {$SELFAUTOLOC,$SELFAUTODIR,$SELFAUTOPARENT}{,{/share,}/texmf{-local,}/web2c}
437 # kpathsea 3.5.3 and later sets these at runtime. To avoid empty
438 # expansions from binaries linked against an earlier version of the
439 # library, we set $progname and $engine to something non-empty:
440 progname = unsetprogname
444 %
\f Part 2: Options.
446 % If this is true, `tex a.b' will look first for a.b.tex (within each
447 % path element), and then for a.b, i.e., we try standard extensions
448 % first. If this is false, we first look for a.b and then a.b.tex,
449 % first. If this is false, we first look for a.b and then a.b.tex,
450 % i.e., we try the name as-is first.
452 % Both names are always tried; the difference is the order in which they
453 % are tried. The setting applies to all searches, not just .tex.
455 % This setting only affects names being looked up which *already* have
456 % an extension. A name without an extension (e.g., `tex story') will
457 % always have an extension added first.
459 % The default is true, because we already avoid adding the standard
460 % extension(s) in most common cases. E.g., babel.sty will only look for
461 % babel.sty, not babel.sty.tex, regardless of this setting.
462 try_std_extension_first = t
464 % Enable system commands via \write18{...}? Obviously insecure, despite
468 % Allow TeX \openin, \openout, or \input on filenames starting with `.'
469 % (e.g., .rhosts) or outside the current tree (e.g., /etc/passwd)?
470 % a (any) : any file can be opened.
471 % r (restricted) : disallow opening "dotfiles".
472 % p (paranoid) : as `r' and disallow going to parent directories, and
473 % restrict absolute paths to be under $TEXMFOUTPUT.
477 % Write .log/.dvi/etc. files here, if the current directory is unwritable.
480 % If a dynamic file creation fails, log the command to this file, in
481 % either the current directory or TEXMFOUTPUT. Set to the
482 % empty string or 0 to avoid logging.
483 MISSFONT_LOG = missfont.log
485 % Set to a colon-separated list of words specifying warnings to suppress.
486 % To suppress everything, use TEX_HUSH = all; this is currently equivalent to
487 % TEX_HUSH = checksum:lostchar:readable:special
488 % To suppress nothing, use TEX_HUSH = none or do not set the variable at all.
491 % Allow TeX, MF, and MP to parse the first line of an input file for
492 % the %&format construct.
495 % But don't parse the first line if invoked as "tex", since we want that
496 % to remain Knuth-compatible. The src_specials and
497 % file_line_error_style settings, as well as the options -enctex,
498 % -mltex, -8bit, etc., also affect this, but they are all off by default.
499 parse_first_line.tex = f
501 % Control file:line:error style messages.
502 file_line_error_style = f
504 % Enable the mktex... scripts by default? These must be set to 0 or 1.
505 % Particular programs can and do override these settings, for example
506 % dvips's -M option. Your first chance to specify whether the scripts
507 % are invoked by default is at configure time.
509 % These values are ignored if the script names are changed; e.g., if you
510 % set DVIPSMAKEPK to `foo', what counts is the value of the environment
511 % variable/config value `FOO', not the `MKTEXPK' value.
521 % What MetaPost runs to make MPX files. This is passed an option -troff
522 % if MP is in troff mode. Set to `0' to disable this feature.
525 % Used by makempx to run TeX. We use "etex" because MetaPost is
526 % expecting DVI, and not "tex" because we want first line parsing.
529 % These variables specify the external program called for the
530 % interactive `e' option. %d is replaced by the line number and %s by
531 % the current filename. The default is specified at compile-time, and
532 % we let that stay in place since different platforms like different values.
533 %TEXEDIT = vi +%d "%s"
537 %
\f Part 3: Array and other sizes for TeX (and Metafont and MetaPost).
539 % If you want to change some of these sizes only for a certain TeX
540 % variant, the usual dot notation works, e.g.,
541 % main_memory.hugetex = 20000000
543 % If a change here appears to be ignored, try redumping the format file.
545 % Memory. Must be less than 8,000,000 total.
547 % main_memory is relevant only to initex, extra_mem_* only to non-ini.
548 % Thus, have to redump the .fmt file after changing main_memory; to add
549 % to existing fmt files, increase extra_mem_*. (To get an idea of how
550 % much, try \tracingstats=2 in your TeX source file;
551 % web2c/tests/memtest.tex might also be interesting.)
553 % To increase space for boxes (as might be needed by, e.g., PiCTeX),
554 % increase extra_mem_bot.
556 % For some xy-pic samples, you may need as much as 700000 words of memory.
557 % For the vast majority of documents, 60000 or less will do.
559 main_memory = 3000000 % words of inimemory available; also applies to inimf&mp
560 extra_mem_top = 0 % extra high memory for chars, tokens, etc.
561 extra_mem_bot = 0 % extra low memory for boxes, glue, breakpoints, etc.
563 % ConTeXt needs lots of memory.
564 extra_mem_top.context = 2000000
565 extra_mem_bot.context = 4000000
567 % Words of font info for TeX (total size of all TFM files, approximately).
568 % Must be >= 20000 and <= 4000000 (without tex.ch changes).
569 font_mem_size = 3000000
571 % Total number of fonts. Must be >= 50 and <= 5000 (without tex.ch changes).
574 % Extra space for the hash table of control sequences (which allows 10K
575 % names as distributed).
578 % Max number of characters in all strings, including all error messages,
579 % help texts, font names, control sequences. These values apply to TeX and MP.
581 % Minimum pool space after TeX/MP's own strings; must be at least
582 % 25000 less than pool_size, but doesn't need to be nearly that large.
583 string_vacancies = 90000
584 % Maximum number of strings.
586 % min pool space left after loading .fmt
589 % Buffer size. TeX uses the buffer to contain input lines, but macro
590 % expansion works by writing material into the buffer and reparsing the
591 % line. As a consequence, certain constructs require the buffer to be
592 % very large, even though most documents can be handled with a small value.
595 % Hyphenation trie. The maximum possible is 4194303 (ssup_trie_size in
596 % the sources), but we don't need that much. The value here suffices
597 % for all known free hyphenation patterns to be loaded simultaneously
598 % (as TeX Live does).
602 hyph_size = 8191 % prime number of hyphenation exceptions, >610, <32767.
603 % http://primes.utm.edu/curios/page.php/8191.html
604 nest_size = 500 % simultaneous semantic levels (e.g., groups)
605 max_in_open = 15 % simultaneous input files and error insertions
606 param_size = 10000 % simultaneous macro parameters
607 save_size = 50000 % for saving values outside current group
608 stack_size = 5000 % simultaneous input sources
610 % These are Omega-specific.
611 ocp_buf_size = 500000 % character buffers for ocp filters.
612 ocp_stack_size = 10000 % stacks for ocp computations.
613 ocp_list_size = 1000 % control for multiple ocps.
615 % Parameter specific to MetaPost.
616 % Maximum number of knots between breakpoints of a path.
617 % Set to 2000 by default.
618 % path_size.mpost = 10000
620 % These work best if they are the same as the I/O buffer size, but it
621 % doesn't matter much. Must be a multiple of 8.
622 dvi_buf_size = 16384 % TeX
623 gf_buf_size = 16384 % MF
625 % It's probably inadvisable to change these. At any rate, we must have:
626 % 45 < error_line < 255;
627 % 30 < half_error_line < error_line - 15;
628 % 60 <= max_print_line;
629 % These apply to TeX, Metafont, and MetaPost.