Patch to texconfig.man
Hi,
while working on packaging for current TeXlive, I found that we apply a
patch to texconfig.man which might be useful for all TeXLive. Please
proofread the result - there were some Debian specific parts in there,
and I edited them out in the diff.
Essentially, it makes a real manpage out of a boilerplate...
I must admit that i don't remember who wrote that, but the archives
indicates that it was me: In the svn log message I write:
,----
| * Write a proper manpage for texconfig, and document which commands
| make sense to be used on a Debian system. Thanks to Géraud Meyer
| <geraud_meyer@hotmail.com> for reminding us (closes: #396823)
`----
Thus, I think I am entitled to put that in the public domain, or in the
continental European sense ;-), hereby allow anyone any copying, use,
distribution and/or modification without restrictions.
Regards, Frank
--
Dr. Frank Küster
Debian Developer (TeXLive)
VCD Aschaffenburg-Miltenberg, ADFC Miltenberg
B90/Grüne KV Miltenberg
--- texlive-bin-2009~svn13478.orig/texk/tetex/texconfig.man 2009-05-26 11:00:20.000000000 +0200
+++ texlive-bin-2009~svn13478/texk/tetex/texconfig.man 2009-05-27 22:50:53.000000000 +0200
@@ -6,22 +6,203 @@
.SH SYNOPSIS
.B texconfig
.LP
+.B texconfig
+[\fB commands\fR ...]
+.LP
.B texconfig-sys
.SH DESCRIPTION
.I texconfig
-allows to configure and maintain
+allows one to configure and maintain
+.I teTeX
+in an easy and convenient manner, offering a series of dialog boxes to
+the user. After choosing settings or options, the appropriate files
+are changed automatically and the new settings are applied for the
+user. If needed, copies of files in
+.I TEXMFDIST
+or
+.I TEXMFMAIN
+will be made in the user's
+.I TEXMFCONFIG
+tree.
+.PP
+.I texconfig
+uses either the
+.IR whiptail (1)
+or
+.IR dialog (1)
+program to communicate with the user, so must be run in a terminal.
+.PP
+For making system-wide changes, which will apply to all users of
.I teTeX
-in an easy and convenient manner. It uses the
-.I dialog
-program to draw nice input boxes. After answering the dialoges, the
-appropriate files are changed automatically and all necessary
-steps are involved to apply the new settings.
+(for example, default paper size and so on), run
+.I texconfig-sys
+instead. Changed or generated files will be placed in
+.I TEXMFSYSCONFIG.
+(You may need ot be root to do this.)
+.PP
+.I texconfig
+also offers a non-interactive batch mode which can be accessed with
+the following commands
+.SH COMMANDS
+Commands that accept further options usually display available options
+if called without them. For example,
+.B texconfig dvipdfm paper
+will inform about valid paper settings.
+.PP
+.B
+.IP conf
+Display the system configuration.
+.PP
+.TP
+.B dvipdfm paper [letter|legal|ledger|tabloid|a4|a3]
+Set up dvipdfm to use papersize PAPER by default.
+.TP
+.B dvips add PRINTERNAME
+Create a new (empty) configuration file
+.I TEXMFCONFIG/dvips/config/config.PRINTERNAME.
+This file can later be filled with the
+.B mode, offset
+or
+.B printcmd
+options
+.TP
+.B dvips del PRINTERNAME
+Remove
+.I config.PRINTERNAME
+.TP
+.B dvips mode
+List available MetaFont modes.
+.TP
+.B dvips [-P PRINTER] mode MODE
+Change the MetaFont mode to
+.I MODE
+for
+.I PRINTER
+or for all output files
+.I (config.ps),
+if no
+.B -P
+option is given.
+.TP
+.B dvips [-P PRINTER] offset x-OFFSET,y-OFFSET
+Set printer offset for
+.I PRINTER
+or for all output files
+.I (config.ps),
+if no
+.B -P
+option is given. Offsets must be given with units, e.g.
+.I 0pt,10pt
+You can use testpage.tex from the LaTeX distribution to find these
+numbers.
+.TP
+.B dvips [-P PRINTER] printcmd CMD
+Set the printing command for
+.I PRINTER
+or for all output files
+.I (config.ps),
+if no
+.B -P
+option is given. Commands might be
+.B lp
+or
+.B lpr.
+See the description of the
+.I o
+option in
+.B info dvips
+or the
+.I -O
+option in
+.B dvips(1).
+.TP
+.B faq
+Display the list of Frequently Asked Questions about
+.B teTeX
+(and their answers).
+.TP
+.B font vardir DIR, font ro, font ro
+.TP
+.B formats
+This command allows to edit
+.B fmtutil.cnf(5)
+and (re)creates any new or changed formats afterwards.
+.TP
+.B hyphen FORMAT
+This command allows to edit the hyphenation configuration file for
+formats that support this, and recreates the formats afterwards to
+enable the new languages. Available formats are shown when no
+.I FORMAT
+is given.
+.IP
+Note that for formats that use LaTeX's
+.I language.dat,
+ e.g.
+.I (pdf)jadetex
+and
+.I latex
+itself, this change is not persistent, since this file is a generated
+file. You should not use this command in these cases, read
+.B update-language(1)
+for alternatives.
+.TP
+.B init [format]
+Recreate
+.I format
+or all formats if none is given, and the font information. This is
+the same as calling
+.B fmtutil --byfmt format
+or
+.B fmtutil --all,
+respectively, followed by
+.B updmap.
+.TP
+.B mode-list
+List available printer modes, together with the printers they were
+developed for, and their DPI resolution
+.TP
+.B mode MODE
+Set the default printer mode in
+.I /etc/texmf/web2c/mktex.cnf
+or the respective user file in
+.I $TEXMFCONFIG/web2c
+to
+.B MODE.
+.TP
+.B paper [a4|letter]
+Set the default papersize for
+.B dvips, dvipdfm, pdftex
+and
+.B xdvi.
+The set is restricted because not all programs understand all sizes.
+.TP
+.B pdftex paper [a4|letter]
+Set the default paper size for
+.B pdftex.
+.TP
+.B rehash
+Call
+.B mktexlsr.
+.TP
+.B xdvi paper PAPER
+Set the default paper size for
+.B xdvi.
+The (long) list is available with
+.B texconfig xdvi paper.
+
+.SH ENVIRONMENT
+To let you change files,
+.B texconfig
+will open the editor specified in the VISUAL or EDITOR variables, or
+.B sensible-editor
+if both are unset.
.SH "SEE ALSO"
+.IR whiptail (1),
.IR dialog (1),
-.IR initex (1),
+.IR tex (1),
.IR mf (1),
.IR vi (1),
.IR EDITOR
-environment-variable.
+environment variable.
.SH AUTHOR
Thomas Esser <te@dbs.uni-hannover.de>
Reply to: