1texconfig(1)                       TeX Live                       texconfig(1)
2
3
4

NAME

6       texconfig - configures teTeX or TeX Live
7
8       texconfig-sys - configures teTeX or TeX Live system-wide
9

SYNOPSIS

11       texconfig
12
13       texconfig [ commands ...]
14
15       texconfig-sys
16

DESCRIPTION

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.
20
21       The tlmgr program has subsumed this function for TeX Live.   This  pro‐
22       gram  is still supported, but the tlmgr interface is much more actively
23       developed and tested.
24
25       After choosing settings or options, the appropriate files  are  changed
26       automatically  and  the  new  settings  are  applied  for the user.  If
27       needed, copies of files in TEXMFDIST or TEXMFMAIN will be made  in  the
28       user's TEXMFCONFIG tree.
29
30       texconfig  uses either the whiptail(1) or dialog(1) program to communi‐
31       cate with the user, so must be run in a terminal.
32
33       For making system-wide changes, which will apply to all  users  of  TeX
34       (for example, default paper size and so on), run texconfig-sys instead.
35       Changed or generated files will be placed in TEXMFSYSCONFIG.  (You  may
36       need to be root to do this.)
37
38       texconfig  also  offers  a  non-interactive  batch  mode  which  can be
39       accessed with the following commands
40

COMMANDS

42       Commands that accept further options usually display available  options
43       if  called  without  them.   For  example, texconfig dvipdfm paper will
44       inform about valid paper settings.
45
46       conf   Display the system configuration.
47
48       dvipdfm paper [letter|legal|ledger|tabloid|a4|a3]
49              Set up dvipdfm to use papersize PAPER by default.
50
51       dvips add PRINTERNAME
52              Create a new (empty) configuration  file  TEXMFCONFIG/dvips/con‐
53              fig/config.PRINTERNAME.   This file can later be filled with the
54              mode, offset or printcmd options
55
56       dvips del PRINTERNAME
57              Remove config.PRINTERNAME
58
59       dvips mode
60              List available MetaFont modes.
61
62       dvips [-P PRINTER] mode MODE
63              Change the MetaFont mode to MODE for PRINTER or for  all  output
64              files (config.ps), if no -P option is given.
65
66       dvips [-P PRINTER] offset x-OFFSET,y-OFFSET
67              Set  printer  offset  for  PRINTER or for all output files (con‐
68              fig.ps), if no -P option is given.  Offsets must be  given  with
69              units,  e.g.   0pt,10pt  You can use testpage.tex from the LaTeX
70              distribution to find these numbers.
71
72       dvips [-P PRINTER] printcmd CMD
73              Set the printing command for PRINTER or  for  all  output  files
74              (config.ps),  if no -P option is given.  Commands might be lp or
75              lpr.  See the description of the o option in info dvips  or  the
76              -O option in dvips(1).
77
78       faq    Display  the list of Frequently Asked Questions about teTeX (and
79              their answers).
80
81       font vardir DIR, font ro, font rw
82
83       formats
84              This command allows to edit fmtutil.cnf(5) and  (re)creates  any
85              new or changed formats afterwards.
86
87       hyphen FORMAT
88              This  command  allows to edit the hyphenation configuration file
89              for formats that support this, and recreates the formats  after‐
90              wards  to enable the new languages.  Available formats are shown
91              when no FORMAT is given.
92
93              Note that for formats that use LaTeX's language.dat,
94               e.g.  (pdf)jadetex and latex itself, this change is not persis‐
95              tent,  since  this file is a generated file.  You should not use
96              this command in these cases, read update-language(1) for  alter‐
97              natives.
98
99       init [format]
100              Recreate  format  or  all formats if none is given, and the font
101              information.  This is the same as calling fmtutil --byfmt format
102              or fmtutil --all, respectively, followed by updmap.
103
104       mode-list
105              List  available  printer  modes, together with the printers they
106              were developed for, and their DPI resolution
107
108       mode MODE
109              Set the default printer mode  in  /etc/texmf/web2c/mktex.cnf  or
110              the respective user file in $TEXMFCONFIG/web2c to MODE.
111
112       paper [a4|letter]
113              Set  the  default papersize for dvips, dvipdfm, pdftex and xdvi.
114              The set is restricted because not all  programs  understand  all
115              sizes.
116
117       pdftex paper [a4|letter]
118              Set the default paper size for pdftex.
119
120       rehash Call mktexlsr.
121
122       xdvi paper PAPER
123              Set  the default paper size for xdvi.  The (long) list is avail‐
124              able with texconfig xdvi paper.
125
126

ENVIRONMENT

128       To let you change files, texconfig will open the  editor  specified  in
129       the VISUAL or EDITOR variables, or sensible-editor if both are unset.
130

SEE ALSO

132       whiptail(1), dialog(1), tlmgr(1), tex(1), mf(1), vi(1), EDITOR environ‐
133       ment variable.
134

AUTHOR

136       Thomas Esser
137
138
139
140TeX Live                          August 2011                     texconfig(1)