summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/tlmgr.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-05-19 01:14:24 +0000
committerKarl Berry <karl@freefriends.org>2016-05-19 01:14:24 +0000
commit7952cb6c46a81fb0365a5fad56cd3f54973b6a1f (patch)
treea5c4a19bbe5305f5936ed60cd205eae72c59af75 /Master/texmf-dist/doc/man/man1/tlmgr.1
parentd1f22626cb114f23080b361b1e37a9754adacc4b (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@41254 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/tlmgr.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.151
1 files changed, 42 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 8add900134c..8178b1e5a0b 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -1541,15 +1541,17 @@ from a given repository:
A summary of the \f(CW\*(C`tlmgr pinning\*(C'\fR actions is given above.
.SH "GUI FOR TLMGR"
.IX Header "GUI FOR TLMGR"
-The graphical user interface for \f(CW\*(C`tlmgr\*(C'\fR needs Perl/Tk to be installed.
-For Windows the necessary modules are shipped within TeX Live, for all
-other (i.e., Unix-based) systems Perl/Tk (as well as Perl of course) has
-to be installed. <http://tug.org/texlive/distro.html#perltk> has a
-list of invocations for some distros.
-.PP
-When started with \f(CW\*(C`tlmgr gui\*(C'\fR the graphical user interface will be
-shown. The main window contains a menu bar, the main display, and a
-status area where messages normally shown on the console are displayed.
+The graphical user interface for \f(CW\*(C`tlmgr\*(C'\fR requires Perl/Tk
+<http://search.cpan.org/search?query=perl%2Ftk>. For Windows the
+necessary modules are shipped within TeX Live, for all other (i.e.,
+Unix-based) systems Perl/Tk (as well as Perl of course) has to be
+installed outside of \s-1TL. \s0<http://tug.org/texlive/distro.html#perltk>
+has a list of invocations for some distros.
+.PP
+The \s-1GUI\s0 is started with the invocation \f(CW\*(C`tlmgr gui\*(C'\fR; assuming Tk is
+loadable, the graphical user interface will be shown. The main window
+contains a menu bar, the main display, and a status area where messages
+normally shown on the console are displayed.
.PP
Within the main display there are three main parts: the \f(CW\*(C`Display
configuration\*(C'\fR area, the list of packages, and the action buttons.
@@ -1702,6 +1704,37 @@ on Windows).
.IX Item "Help menu"
Provides access to the TeX Live manual (also on the web at
<http://tug.org/texlive/doc.html>) and the usual ``About'' box.
+.SS "\s-1GUI\s0 options"
+.IX Subsection "GUI options"
+Some generic Perl/Tk options can be specified with \f(CW\*(C`tlmgr gui\*(C'\fR to
+control the display:
+.ie n .IP """\-background"" \fIcolor\fR" 4
+.el .IP "\f(CW\-background\fR \fIcolor\fR" 4
+.IX Item "-background color"
+Set background color.
+.ie n .IP """\-font """" \fIfontname\fR \fIfontsize\fR """"""" 4
+.el .IP "\f(CW\-font ``\fR \fIfontname\fR \fIfontsize\fR \f(CW''\fR" 4
+.IX Item "-font "" fontname fontsize """
+Set font, e.g., \f(CW\*(C`tlmgr gui \-font "helvetica 18"\*(C'\fR. The argument to
+\&\f(CW\*(C`\-font\*(C'\fR must be quoted, i.e., passed as a single string.
+.ie n .IP """\-foreground"" \fIcolor\fR" 4
+.el .IP "\f(CW\-foreground\fR \fIcolor\fR" 4
+.IX Item "-foreground color"
+Set foreground color.
+.ie n .IP """\-geometry"" \fIgeomspec\fR" 4
+.el .IP "\f(CW\-geometry\fR \fIgeomspec\fR" 4
+.IX Item "-geometry geomspec"
+Set the X geometry, e.g., \f(CW\*(C`tlmgr gui \-geometry 1024x512\-0+0\*(C'\fR creates
+the window of (approximately) the given size in the upper-right corner
+of the display.
+.ie n .IP """\-xrm"" \fIxresource\fR" 4
+.el .IP "\f(CW\-xrm\fR \fIxresource\fR" 4
+.IX Item "-xrm xresource"
+Pass the arbitrary X resource string \fIxresource\fR.
+.PP
+A few other obscure options are recognized but not mentioned here. See
+the Perl/Tk documentation (<http://search.cpan.org/perldoc?Tk>) for the
+complete list, and any X documentation for general information.
.SH "MACHINE-READABLE OUTPUT"
.IX Header "MACHINE-READABLE OUTPUT"
With the \f(CW\*(C`\-\-machine\-readable\*(C'\fR option, \f(CW\*(C`tlmgr\*(C'\fR writes to stdout in the