source/texk/texlive/tl_scripts/texconfig.1

   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