2999
|
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.cnf.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.cnf.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 |
|
40 % Part 1: Search paths and directories. |
|
41 |
|
42 % The root of everything below. |
|
43 prefix = @prefix@ |
|
44 |
|
45 % You can set an environment variable to override this if you're testing |
|
46 % a new TeX tree, without changing anything else. |
|
47 % |
|
48 % You may wish to use one of the $SELFAUTO... variables here so TeX will |
|
49 % find where to look dynamically. See the manual and the definition |
|
50 % below of TEXMFCNF. |
|
51 % |
|
52 % If you have multiple trees, you can use shell brace notation, for example: |
|
53 % TEXMF = {/usr/local/mytex,/usr/local/othertex} |
|
54 % Also set TEXMFDBS to /usr/local/mytex:/usr/local/othertex, |
|
55 % and set TEXMFMAIN to whichever is the main tree (with ./web2c, etc.), |
|
56 % and set TEXMFLS_R to the tree where you want generated files to go |
|
57 % |
|
58 TEXMF = @texmf@ |
|
59 % Change this if you have multiple trees or MakeTeX* will fail: |
|
60 TEXMFMAIN = $TEXMF |
|
61 % (this is the default) TEXMFLS_R = $TEXMFMAIN |
|
62 % (this is the default) TEXMFCNF_DIR = $TEXMFMAIN |
|
63 |
|
64 % Where to look for ls-R files. There need not be an ls-R in the |
|
65 % directories in this path, but if there is one, Kpathsea will use it. |
|
66 TEXMFDBS = $TEXMF |
|
67 |
|
68 % The TeX inputs and fonts directories. |
|
69 texdir = @texinputdir@ |
|
70 fontdir = @fontdir@ |
|
71 |
|
72 % To avoid searching the filesystem, use the commented-out definitions here. |
|
73 %dbtex = !!$texdir |
|
74 %dbfonts = !!$fontdir |
|
75 dbtex = $texdir |
|
76 dbfonts = $fontdir |
|
77 |
|
78 % TeX input files -- i.e., anything to be found by \input or \openin, |
|
79 % including .sty, .eps, etc. |
|
80 TEXINPUTS = .:$dbtex// |
|
81 |
|
82 % LaTeX 2e specific macros are stored in latex/, macros that can only be |
|
83 % used with 2.09 in latex209/. In addition, we look in the directory |
|
84 % latex2, useful for macros that were written for 2.09 and do not |
|
85 % mention 2e at all, but can be used with 2e. |
|
86 latex209_inputs = .:$dbtex/latex209//:$dbtex/latex//:$dbtex/generic// |
|
87 latex2e_inputs = .:$dbtex/latex//:$dbtex/latex209//:$dbtex/generic// |
|
88 TEXINPUTS.latex209 = $latex209_inputs |
|
89 TEXINPUTS.latex2e = $latex2e_inputs |
|
90 TEXINPUTS.latex = $latex2e_inputs |
|
91 |
|
92 % Fontinst needs to read afm files. |
|
93 TEXINPUTS.fontinst = .:$dbtex//:$dbfonts//afm// |
|
94 |
|
95 % Plain TeX. Have the command tex check all directories as a last |
|
96 % resort, we may have plain-compatible stuff anywhere. |
|
97 plain_inputs = $dbtex/plain//:$dbtex/generic// |
|
98 TEXINPUTS.tex = .:$plain_inputs:$dbtex// |
|
99 % other plain-based formats |
|
100 TEXINPUTS.amstex = .:$dbtex/amstex//:$plain_inputs |
|
101 TEXINPUTS.ftex = .:$dbtex/formate//:$plain_inputs |
|
102 TEXINPUTS.texinfo = .:$dbtex/texinfo//:$plain_inputs |
|
103 |
|
104 % INITEX. May as well make this separate so it can search on disk; |
|
105 % initex is seldom run, and might be used directly after files have been |
|
106 % added, when ls-R may not up be to date. |
|
107 TEXINPUTS.initex = .:$texdir// |
|
108 |
|
109 % Earlier entries override later ones, so put this last. |
|
110 TEXINPUTS = .:$dbtex// |
|
111 |
|
112 % Metafont, MetaPost inputs. |
|
113 MFINPUTS = .:@mfinputdir@//:{$dbfonts,$VARTEXFONTS}//source// |
|
114 MPINPUTS = .:@mpinputdir@// |
|
115 |
|
116 % Dump files (fmt/base/mem) for vir{tex,mf,mp} to read (see |
|
117 % web2c/INSTALL), and string pools (.pool) for ini{tex,mf,mp}. It is |
|
118 % silly that we have six paths and directories here (they all resolve to |
|
119 % a single place by default), but historically ... |
|
120 TEXFORMATS = .:@fmtdir@ |
|
121 MFBASES = .:@basedir@ |
|
122 MPMEMS = .:@memdir@ |
|
123 TEXPOOL = .:@texpooldir@ |
|
124 MFPOOL = .:@mfpooldir@ |
|
125 MPPOOL = .:@mppooldir@ |
|
126 |
|
127 % If you have a read-only central font directory and therefore need to |
|
128 % cache MakeTeXPK-created fonts locally, set this as appropriate and |
|
129 % also set the `vartexfonts' feature in MT_FEATURES in MakeTeXnames.cnf. |
|
130 VARTEXFONTS = /var/tex/fonts |
|
131 |
|
132 % Device-independent font metric files. |
|
133 VFFONTS = .:$dbfonts//vf// |
|
134 TFMFONTS = .:{$dbfonts,$VARTEXFONTS}//tfm// |
|
135 |
|
136 % The $MAKETEX_MODE below means the drivers will not use a cx font when |
|
137 % the mode is ricoh. If no mode is explicitly specified, kpse_prog_init |
|
138 % sets MAKETEX_MODE to /, so all subdirectories are searched. See the manual. |
|
139 PKFONTS = .:{$dbfonts,$VARTEXFONTS}//pk/$MAKETEX_MODE// |
|
140 |
|
141 % xdvi needs to find bitmaps for PostScript fonts, which can be |
|
142 % generated by the standalone program gsftopk, among others. |
|
143 PKFONTS.xdvi = .:{$dbfonts,$VARTEXFONTS}//pk/{$MAKETEX_MODE,modeless}// |
|
144 |
|
145 % Similarly for the GF format, which only remains in existence because |
|
146 % Metafont outputs it (and MF isn't going to change). |
|
147 GFFONTS = .:$dbfonts//gf/$MAKETEX_MODE// |
|
148 |
|
149 % A backup for PKFONTS and GFFONTS. Not used for anything. |
|
150 GLYPHFONTS = .:$dbfonts |
|
151 |
|
152 % For texfonts.map and included map files used by MakeTeXPK. |
|
153 % See ftp://ftp.tug.org/tex/fontname.tar.gz. |
|
154 TEXFONTMAPS = .:$TEXMF/fontname |
|
155 |
|
156 % BibTeX bibliographies and style files. |
|
157 BIBINPUTS = .:$TEXMF/bibtex/bib// |
|
158 BSTINPUTS = .:$TEXMF/bibtex/bst// |
|
159 |
|
160 % MFT style files. |
|
161 MFTINPUTS = .:$TEXMF/mft// |
|
162 |
|
163 % PostScript headers, prologues (.pro), encodings (.enc) and fonts. |
|
164 TEXPSHEADERS = .:@psheaderdir@//:$dbfonts//type1// |
|
165 |
|
166 % PostScript Type 1 outline fonts. |
|
167 T1FONTS = .:$dbfonts//type1// |
|
168 |
|
169 % PostScript AFM metric files. |
|
170 AFMFONTS = .:$dbfonts//afm// |
|
171 |
|
172 % Dvips' config.* files (this name should not start with `TEX'!). |
|
173 TEXCONFIG = .:@dvipsdir@// |
|
174 |
|
175 % Makeindex style (.ist) files. |
|
176 INDEXSTYLE = .:$TEXMF/makeindex// |
|
177 |
|
178 % Used by DMP (ditroff-to-mpx), called by makempx -troff. |
|
179 TRFONTS = /usr/lib/font/devpost |
|
180 MPSUPPORT = .:$TEXMF/metapost/support |
|
181 |
|
182 % For xdvi to find mime.types and .mailcap, if they do not exist in |
|
183 % $HOME. These are single directories, not paths. |
|
184 % (But the default mime.types, at least, may well suffice.) |
|
185 MIMELIBDIR = $prefix/etc |
|
186 MAILCAPLIBDIR = $prefix/etc |
|
187 |
|
188 % TeX documentation and source files, for use with kpsewhich. |
|
189 TEXDOCS = .:$TEXMF/doc// |
|
190 TEXSOURCES = .:$TEXMF/source// |
|
191 |
|
192 % Omega-related fonts and other files. |
|
193 OFMFONTS = .:{$dbfonts,$VARTEXFONTS}//ofm// |
|
194 OPLFONTS = .:{$dbfonts,$VARTEXFONTS}//opl// |
|
195 OVFFONTS = .:{$dbfonts,$VARTEXFONTS}//ovf// |
|
196 OVPFONTS = .:{$dbfonts,$VARTEXFONTS}//ovp// |
|
197 OTPINPUTS = .:$TEXMF/omega/otp// |
|
198 OCPINPUTS = .:$TEXMF/omega/ocp// |
|
199 |
|
200 % The MakeTeX* scripts rely on KPSE_DOT. Do not change it. |
|
201 KPSE_DOT = . |
|
202 |
|
203 % This definition isn't used from this .cnf file itself (that would be |
|
204 % paradoxical), but the compile-time default in paths.h is built from it. |
|
205 % The SELFAUTO* variables are set automatically from the location of |
|
206 % argv[0], in kpse_set_progname. |
|
207 % |
|
208 % About the /. construction: |
|
209 % 1) if the variable is undefined, we'd otherwise have an empty path |
|
210 % element in the compile-time path. This is not meaningful. |
|
211 % 2) if we used /$VARIABLE, we'd end up with // if VARIABLE is defined, |
|
212 % which would search the entire world. |
|
213 % |
|
214 % The TETEXDIR stuff isn't likely to relevant unless you're using teTeX, |
|
215 % but it doesn't hurt. |
|
216 % |
|
217 web2cdir = @web2cdir@ |
|
218 TEXMFCNF = .:$SELFAUTOLOC:$SELFAUTODIR:$SELFAUTODIR/share/texmf/web2c:$SELFAUTOPARENT:$SELFAUTOPARENT/share/texmf/web2c:/.$TETEXDIR:/.$TEXMF/web2c:$web2cdir |
|
219 |
|
220 |
|
221 % Part 2: Non-path options. |
|
222 |
|
223 % Write .log/.dvi/etc. files here, if the current directory is unwritable. |
|
224 % TEXMFOUTPUT = /tmp |
|
225 |
|
226 % If a dynamic file creation fails, log the command to this file, in |
|
227 % either the current directory or TEXMFOUTPUT. Set to the |
|
228 % empty string or 0 to avoid logging. |
|
229 MISSFONT_LOG = missfont.log |
|
230 |
|
231 % Set to a colon-separated list of words specifying warnings to suppress. |
|
232 % To suppress everything, use TEX_HUSH = all; this is equivalent to |
|
233 % TEX_HUSH = checksum:lostchar:readable:special |
|
234 TEX_HUSH = 0 |
|
235 |
|
236 % Enable system commands via \write18{...}? |
|
237 shell_escape = 0 |
|
238 |
|
239 % Allow TeX \openout on filenames starting with `.' (e.g., .rhosts)? |
|
240 openout_any = 0 |
|
241 |
|
242 % Enable the MakeTeX... scripts by default? These must be set to 0 or 1. |
|
243 % Particular programs can and do override these settings, for example |
|
244 % dvips's -M option. Your first chance to specify whether the scripts |
|
245 % are invoked by default is at configure time. |
|
246 % |
|
247 % These values are ignored if the script names are changed; e.g., if you |
|
248 % set DVIPSMAKEPK to `foo', what counts is the value of the environment |
|
249 % variable/config value `FOO', not the `MAKETEXPK' value. |
|
250 % |
|
251 % MAKETEXTEX = 0 |
|
252 % MAKETEXPK = 0 |
|
253 % MAKETEXMF = 0 |
|
254 % MAKETEXTFM = 0 |
|
255 |
|
256 % What MetaPost runs to make MPX files. This is passed an option -troff |
|
257 % if MP is in troff mode. Set to `0' to disable this feature. |
|
258 MPXCOMMAND = makempx |
|
259 |
|
260 |
|
261 % Part 3: Array and other sizes for TeX (and Metafont and MetaPost). |
|
262 % |
|
263 % If you want to change some of these sizes only for a certain TeX |
|
264 % variant, the usual dot notation works, e.g., |
|
265 % main_memory.hugetex = 20000000 |
|
266 % |
|
267 % If a change here appears to be ignored, try redumping the format file. |
|
268 |
|
269 % Memory. Must be less than 8,000,000 total. |
|
270 % |
|
271 % main_memory is relevant only to initex, extra_mem_* only to non-ini. |
|
272 % Thus, have to redump the .fmt file after changing main_memory; to add |
|
273 % to existing fmt files, increase extra_mem_*. (To get an idea of how |
|
274 % much, try \tracingstats=2 in your TeX source file; |
|
275 % web2c/tests/memtest.tex might also be interesting.) |
|
276 % |
|
277 % To increase space for boxes (as might be needed by, e.g., PiCTeX), |
|
278 % increase extra_mem_bot. |
|
279 % |
|
280 % For some xy-pic samples, you may need as much as 700000 words of memory. |
|
281 % For the vast majority of documents, 60000 or less will do. |
|
282 % |
|
283 main_memory = 263000 % words of inimemory available; also applies to inimf&mp |
|
284 extra_mem_top = 0 % extra high memory for chars, tokens, etc. |
|
285 extra_mem_bot = 0 % extra low memory for boxes, glue, breakpoints, etc. |
|
286 |
|
287 % Words of font info for TeX (total size of all TFM files, approximately). |
|
288 font_mem_size = 100000 |
|
289 |
|
290 % Total number of fonts. Must be >= 50 and <= 2000 (without tex.ch changes). |
|
291 font_max = 500 |
|
292 |
|
293 % Extra space for the hash table of control sequences (which allows 10K |
|
294 % names as distributed). |
|
295 hash_extra = 0 |
|
296 |
|
297 % Max number of characters in all strings, including all error messages, |
|
298 % help texts, font names, control sequences. These values apply to TeX and MP. |
|
299 pool_size = 125000 |
|
300 % Minimum pool space after TeX/MP's own strings; must be at least |
|
301 % 25000 less than pool_size, but doesn't need to be nearly that large. |
|
302 string_vacancies = 25000 |
|
303 max_strings = 15000 % max number of strings |
|
304 pool_free = 5000 % min pool space left after loading .fmt |
|
305 |
|
306 % Hyphenation trie. As distributed, the maximum is 65535; this should |
|
307 % work unless `unsigned short' is not supported or is smaller than 16 |
|
308 % bits. This value should suffice for UK English, US English, French, |
|
309 % and German (for example). To increase, you must change |
|
310 % `ssup_trie_opcode' and `ssup_trie_size' in tex.ch (and rebuild TeX); |
|
311 % the trie will then consume four bytes per entry, instead of two. |
|
312 % |
|
313 % US English, German, and Portuguese: 30000. |
|
314 % German: 14000. |
|
315 % US English: 10000. |
|
316 % |
|
317 trie_size = 64000 |
|
318 |
|
319 hyph_size = 1000 % number of hyphenation exceptions, >610 and <32767. |
|
320 buf_size = 3000 % max length of input lines or control sequence names |
|
321 nest_size = 100 % simultaneous semantic levels (e.g., groups) |
|
322 max_in_open = 15 % simultaneous input files and error insertions |
|
323 param_size = 500 % simultaneous macro parameters |
|
324 save_size = 4000 % for saving values outside current group |
|
325 stack_size = 300 % simultaneous input sources |
|
326 |
|
327 % These work best if they are the same as the I/O buffer size, but it |
|
328 % doesn't matter much. Must be a multiple of 8. |
|
329 dvi_buf_size = 16384 % TeX |
|
330 gf_buf_size = 16384 % MF |
|
331 |
|
332 % It's probably inadvisable to change these. At any rate, we must have: |
|
333 % 45 < error_line < 255; |
|
334 % 30 < half_error_line < error_line - 15; |
|
335 % max_print_line < 60 ; |
|
336 % These apply to Metafont and MetaPost as well. |
|
337 error_line = 79 |
|
338 half_error_line = 50 |
|
339 max_print_line = 79 |