| 1 |
.TH texconfig 1 "July 2014" "TeX Live" "TeX Live" |
| 2 |
.SH NAME |
| 3 |
texconfig \- configures teTeX or TeX Live |
| 4 |
.LP |
| 5 |
texconfig-sys \- configures teTeX or TeX Live system\-wide |
| 6 |
.SH SYNOPSIS |
| 7 |
.B texconfig |
| 8 |
.LP |
| 9 |
.B texconfig |
| 10 |
[\fB commands\fR ...] |
| 11 |
.LP |
| 12 |
.B texconfig-sys |
| 13 |
.SH DESCRIPTION |
| 14 |
.I texconfig |
| 15 |
allows one to configure and maintain TeX in an easy and convenient |
| 16 |
manner, offering a series of dialog boxes to the user. The directory in |
| 17 |
which \fItexconfig\fP is found is also preferentially used to find |
| 18 |
subprograms. |
| 19 |
.PP |
| 20 |
The |
| 21 |
.I tlmgr |
| 22 |
program has subsumed this function for TeX Live. This program |
| 23 |
is still supported, but the tlmgr interface is much more actively |
| 24 |
developed and tested. |
| 25 |
.PP |
| 26 |
After choosing settings or options, the appropriate files |
| 27 |
are changed automatically and the new settings are applied for the |
| 28 |
user. If needed, copies of files in |
| 29 |
.I TEXMFDIST |
| 30 |
or |
| 31 |
.I TEXMFMAIN |
| 32 |
will be made in the user's |
| 33 |
.I TEXMFCONFIG |
| 34 |
tree. |
| 35 |
.PP |
| 36 |
.I texconfig |
| 37 |
uses either the |
| 38 |
.IR whiptail (1) |
| 39 |
or |
| 40 |
.IR dialog (1) |
| 41 |
program to communicate with the user, so must be run in a terminal. |
| 42 |
.PP |
| 43 |
For making system-wide changes, which will apply to all users of TeX |
| 44 |
(for example, default paper size and so on), run |
| 45 |
.I texconfig-sys |
| 46 |
instead. Changed or generated files will be placed in |
| 47 |
.IR TEXMFSYSCONFIG . |
| 48 |
(You may need to be root to do this.) |
| 49 |
.PP |
| 50 |
.I texconfig |
| 51 |
also offers a non-interactive batch mode which can be accessed with |
| 52 |
the following commands |
| 53 |
.SH COMMANDS |
| 54 |
Commands that accept further options usually display available options |
| 55 |
if called without them. For example, |
| 56 |
.B texconfig dvipdfm paper |
| 57 |
will inform about valid paper settings. |
| 58 |
.PP |
| 59 |
.B |
| 60 |
.IP conf |
| 61 |
Display the system configuration. |
| 62 |
.PP |
| 63 |
.TP |
| 64 |
.B dvipdfm paper [letter|legal|ledger|tabloid|a4|a3] |
| 65 |
Set up dvipdfm to use papersize PAPER by default. |
| 66 |
.TP |
| 67 |
.B dvips add PRINTERNAME |
| 68 |
Create a new (empty) configuration file |
| 69 |
.I TEXMFCONFIG/dvips/config/config.PRINTERNAME. |
| 70 |
This file can later be filled with the |
| 71 |
.B mode, offset |
| 72 |
or |
| 73 |
.B printcmd |
| 74 |
options |
| 75 |
.TP |
| 76 |
.B dvips del PRINTERNAME |
| 77 |
Remove |
| 78 |
.I config.PRINTERNAME |
| 79 |
.TP |
| 80 |
.B dvips mode |
| 81 |
List available Metafont modes. |
| 82 |
.TP |
| 83 |
.B dvips [-P PRINTER] mode MODE |
| 84 |
Change the Metafont mode to |
| 85 |
.I MODE |
| 86 |
for |
| 87 |
.I PRINTER |
| 88 |
or for all output files |
| 89 |
.I (config.ps), |
| 90 |
if no |
| 91 |
.B -P |
| 92 |
option is given. |
| 93 |
.TP |
| 94 |
.B dvips [-P PRINTER] offset x-OFFSET,y-OFFSET |
| 95 |
Set printer offset for |
| 96 |
.I PRINTER |
| 97 |
or for all output files |
| 98 |
.I (config.ps), |
| 99 |
if no |
| 100 |
.B -P |
| 101 |
option is given. Offsets must be given with units, e.g. |
| 102 |
.I 0pt,10pt |
| 103 |
You can use testpage.tex from the LaTeX distribution to find these |
| 104 |
numbers. |
| 105 |
.TP |
| 106 |
.B dvips [-P PRINTER] printcmd CMD |
| 107 |
Set the printing command for |
| 108 |
.I PRINTER |
| 109 |
or for all output files |
| 110 |
.I (config.ps), |
| 111 |
if no |
| 112 |
.B -P |
| 113 |
option is given. Commands might be |
| 114 |
.B lp |
| 115 |
or |
| 116 |
.B lpr. |
| 117 |
See the description of the |
| 118 |
.I o |
| 119 |
option in |
| 120 |
.B info dvips |
| 121 |
or the |
| 122 |
.I -O |
| 123 |
option in |
| 124 |
.B dvips(1). |
| 125 |
.TP |
| 126 |
.B faq |
| 127 |
Display the list of Frequently Asked Questions about |
| 128 |
.B teTeX |
| 129 |
(and their answers). |
| 130 |
.TP |
| 131 |
.B font vardir DIR, font ro, font rw |
| 132 |
.TP |
| 133 |
.B formats |
| 134 |
This command allows to edit |
| 135 |
.B fmtutil.cnf(5) |
| 136 |
and (re)creates any new or changed formats afterwards. |
| 137 |
.TP |
| 138 |
.B hyphen FORMAT |
| 139 |
This command allows to edit the hyphenation configuration file for |
| 140 |
formats that support this, and recreates the formats afterwards to |
| 141 |
enable the new languages. Available formats are shown when no |
| 142 |
.I FORMAT |
| 143 |
is given. |
| 144 |
.IP |
| 145 |
Note that for formats that use LaTeX's |
| 146 |
.I language.dat, |
| 147 |
e.g. |
| 148 |
.I (pdf)jadetex |
| 149 |
and |
| 150 |
.I latex |
| 151 |
itself, this change is not persistent, since this file is a generated |
| 152 |
file. You should not use this command in these cases, read |
| 153 |
.B update-language(1) |
| 154 |
for alternatives. |
| 155 |
.TP |
| 156 |
.B init [format] |
| 157 |
Recreate |
| 158 |
.I format |
| 159 |
or all formats if none is given, and the font information. This is |
| 160 |
the same as calling |
| 161 |
.B fmtutil --byfmt format |
| 162 |
or |
| 163 |
.B fmtutil --all, |
| 164 |
respectively, followed by |
| 165 |
.B updmap. |
| 166 |
.TP |
| 167 |
.B mode-list |
| 168 |
List available printer modes, together with the printers they were |
| 169 |
developed for, and their DPI resolution |
| 170 |
.TP |
| 171 |
.B mode MODE |
| 172 |
Set the default printer mode in |
| 173 |
.I /etc/texmf/web2c/mktex.cnf |
| 174 |
or the respective user file in |
| 175 |
.I $TEXMFCONFIG/web2c |
| 176 |
to |
| 177 |
.B MODE. |
| 178 |
.TP |
| 179 |
.B paper [a4|letter] |
| 180 |
Set the default papersize for |
| 181 |
.B dvips, dvipdfm, pdftex |
| 182 |
and |
| 183 |
.B xdvi. |
| 184 |
The set is restricted because not all programs understand all sizes. |
| 185 |
.TP |
| 186 |
.B pdftex paper [a4|letter] |
| 187 |
Set the default paper size for |
| 188 |
.B pdftex. |
| 189 |
.TP |
| 190 |
.B rehash |
| 191 |
Call |
| 192 |
.B mktexlsr. |
| 193 |
.TP |
| 194 |
.B xdvi paper PAPER |
| 195 |
Set the default paper size for |
| 196 |
.B xdvi. |
| 197 |
The (long) list is available with |
| 198 |
.B texconfig xdvi paper. |
| 199 |
|
| 200 |
.SH ENVIRONMENT |
| 201 |
To let you change files, |
| 202 |
.B texconfig |
| 203 |
will open the editor specified in the VISUAL or EDITOR variables, or |
| 204 |
.B sensible-editor |
| 205 |
if both are unset. |
| 206 |
.SH "SEE ALSO" |
| 207 |
.IR whiptail (1), |
| 208 |
.IR dialog (1), |
| 209 |
.IR tlmgr (1), |
| 210 |
.IR tex (1), |
| 211 |
.IR mf (1), |
| 212 |
.IR vi (1), |
| 213 |
.IR EDITOR |
| 214 |
environment variable. |
| 215 |
.SH AUTHOR |
| 216 |
Thomas Esser |