view kpathsea/texmf.cnf.in @ 2999:faa5d0421460

[project @ 1997-05-23 03:02:09 by jwe]
author jwe
date Fri, 23 May 1997 03:02:36 +0000
parents
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