1texconfig(1) TeX Live texconfig(1)
2
6 texconfig - configures teTeX or TeX Live
7 texconfig-sys - configures teTeX or TeX Live system-wide
9
11 texconfig
12 texconfig [ commands ...]
14 texconfig-sys
16
18 texconfig allows one to configure and maintain TeX in an easy and con‐
19 venient manner, offering a series of dialog boxes to the user. The
20 directory in which texconfig is found is also preferentially used to
21 find subprograms.
22 The tlmgr program has subsumed this function for TeX Live. This pro‐
24 gram is still supported, but the tlmgr interface is much more actively
25 developed and tested.
26 After choosing settings or options, the appropriate files are changed
28 automatically and the new settings are applied for the user. If
29 needed, copies of files in TEXMFDIST or TEXMFMAIN will be made in the
30 user's TEXMFCONFIG tree.
31 texconfig uses either the whiptail(1) or dialog(1) program to communi‐
33 cate with the user, so must be run in a terminal.
34 For making system-wide changes, which will apply to all users of TeX
36 (for example, default paper size and so on), run texconfig-sys instead.
37 Changed or generated files will be placed in TEXMFSYSCONFIG. (You may
38 need to be root to do this.)
39 texconfig also offers a non-interactive batch mode which can be
41 accessed with the following commands
42
44 Commands that accept further options usually display available options
45 if called without them. For example, texconfig dvipdfm paper will
46 inform about valid paper settings.
47 conf Display the system configuration.
49 dvipdfm paper [letter|legal|ledger|tabloid|a4|a3]
51 Set up dvipdfm to use papersize PAPER by default.
52 dvips add PRINTERNAME
54 Create a new (empty) configuration file TEXMFCONFIG/dvips/con‐
55 fig/config.PRINTERNAME. This file can later be filled with the
56 mode, offset or printcmd options
57 dvips del PRINTERNAME
59 Remove config.PRINTERNAME
60 dvips mode
62 List available Metafont modes.
63 dvips [-P PRINTER] mode MODE
65 Change the Metafont mode to MODE for PRINTER or for all output
66 files (config.ps), if no -P option is given.
67 dvips [-P PRINTER] offset x-OFFSET,y-OFFSET
69 Set printer offset for PRINTER or for all output files (con‐
70 fig.ps), if no -P option is given. Offsets must be given with
71 units, e.g. 0pt,10pt You can use testpage.tex from the LaTeX
72 distribution to find these numbers.
73 dvips [-P PRINTER] printcmd CMD
75 Set the printing command for PRINTER or for all output files
76 (config.ps), if no -P option is given. Commands might be lp or
77 lpr. See the description of the o option in info dvips or the
78 -O option in dvips(1).
79 faq Display the list of Frequently Asked Questions about teTeX (and
81 their answers).
82 font vardir DIR, font ro, font rw
84 formats
86 This command allows to edit fmtutil.cnf(5) and (re)creates any
87 new or changed formats afterwards.
88 hyphen FORMAT
90 This command allows to edit the hyphenation configuration file
91 for formats that support this, and recreates the formats after‐
92 wards to enable the new languages. Available formats are shown
93 when no FORMAT is given.
94 Note that for formats that use LaTeX's language.dat,
96 e.g. (pdf)jadetex and latex itself, this change is not persis‐
97 tent, since this file is a generated file. You should not use
98 this command in these cases, read update-language(1) for alter‐
99 natives.
100 init [format]
102 Recreate format or all formats if none is given, and the font
103 information. This is the same as calling fmtutil --byfmt format
104 or fmtutil --all, respectively, followed by updmap.
105 mode-list
107 List available printer modes, together with the printers they
108 were developed for, and their DPI resolution
109 mode MODE
111 Set the default printer mode in /etc/texmf/web2c/mktex.cnf or
112 the respective user file in $TEXMFCONFIG/web2c to MODE.
113 paper [a4|letter]
115 Set the default papersize for dvips, dvipdfm, pdftex and xdvi.
116 The set is restricted because not all programs understand all
117 sizes.
118 pdftex paper [a4|letter]
120 Set the default paper size for pdftex.
121 rehash Call mktexlsr.
123 xdvi paper PAPER
125 Set the default paper size for xdvi. The (long) list is avail‐
126 able with texconfig xdvi paper.
127
130 To let you change files, texconfig will open the editor specified in
131 the VISUAL or EDITOR variables, or sensible-editor if both are unset.
132
134 whiptail(1), dialog(1), tlmgr(1), tex(1), mf(1), vi(1), EDITOR environ‐
135 ment variable.
136
138 Thomas Esser
139TeX Live July 2014 texconfig(1)