summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/scripts
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-05-18 18:00:35 +0000
committerKarl Berry <karl@freefriends.org>2016-05-18 18:00:35 +0000
commit43d037e2d59993148898809f33d60fb77dbeb869 (patch)
treec147b28e67858d59efee8ddf05b6e722cf656750 /Master/texmf-dist/scripts
parent018d361b550e9ae72dcbf31acb6e614bf3a137fc (diff)
gui doc
git-svn-id: svn://tug.org/texlive/trunk@41236 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/scripts')
-rwxr-xr-xMaster/texmf-dist/scripts/texlive/tlmgr.pl106
1 files changed, 72 insertions, 34 deletions
diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl
index 9d5a6bd43fb..c25546ce5ed 100755
--- a/Master/texmf-dist/scripts/texlive/tlmgr.pl
+++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl
@@ -143,9 +143,9 @@ my %action_specification = (
},
"backup" => {
"options" => {
+ "all" => 1,
"backupdir" => "=s",
"clean" => ":-99",
- "all" => 1,
"dry-run|n" => 1
},
"run-post" => 1,
@@ -175,8 +175,8 @@ my %action_specification = (
},
"generate" => {
"options" => {
- "localcfg" => "=s",
"dest" => "=s",
+ "localcfg" => "=s",
"rebuild-sys" => 1
},
"run-post" => 1,
@@ -190,19 +190,19 @@ my %action_specification = (
"options" => {
"load" => 1,
# Tk::CmdLine options
- "font" => "=s",
"background" => "=s",
"class" => "=s",
"display" => "=s",
- "screen" => "=s",
+ "font" => "=s",
"foreground" => "=s",
"geometry" => "=s",
- "name" => "=s",
- "title" => "=s",
- "xrm" => "=s",
"iconic" => 1,
"motif" => 1,
+ "name" => "=s",
+ "screen" => "=s",
"synchronous" => 1,
+ "title" => "=s",
+ "xrm" => "=s",
},
"run-post" => 1,
"function" => \&action_gui
@@ -218,12 +218,12 @@ my %action_specification = (
},
"install" => {
"options" => {
+ "dry-run|n" => 1,
+ "file" => 1,
+ "force" => 1,
"no-depends" => 1,
"no-depends-at-all" => 1,
- "file" => 1,
"reinstall" => 1,
- "force" => 1,
- "dry-run|n" => 1,
"with-doc" => 1,
"with-src" => 1,
},
@@ -260,24 +260,24 @@ my %action_specification = (
},
"postaction" => {
"options" => {
- "w32mode" => "=s",
"all" => 1,
"fileassocmode" => "=i"
+ "w32mode" => "=s",
},
"run-post" => 0,
"function" => \&action_postaction
},
"recreate-tlpdb" => {
+ "function" => \&action_recreate_tlpdb
"options" => { "platform|arch" => "=s" },
"run-post" => 0,
- "function" => \&action_recreate_tlpdb
},
"remove" => {
"options" => {
+ "dry-run|n" => 1
+ "force" => 1,
"no-depends" => 1,
"no-depends-at-all" => 1,
- "force" => 1,
- "dry-run|n" => 1
},
"run-post" => 1,
"function" => \&action_remove
@@ -289,9 +289,9 @@ my %action_specification = (
},
"restore" => {
"options" => {
+ "all" => 1,
"backupdir" => "=s",
"dry-run|n" => 1,
- "all" => 1,
"force" => 1
},
"run-post" => 1,
@@ -299,10 +299,10 @@ my %action_specification = (
},
"search" => {
"options" => {
+ "all" => 1,
+ "file" => 1,
"global" => 1,
"word" => 1,
- "file" => 1,
- "all" => 1,
},
"run-post" => 1,
"function" => \&action_search
@@ -314,19 +314,19 @@ my %action_specification = (
},
"update" => {
"options" => {
- "no-depends" => 1,
- "no-depends-at-all" => 1,
"all" => 1,
- "self" => 1,
+ "backup" => 1,
+ "backupdir" => "=s",
+ "dry-run|n" => 1
+ "exclude" => "=s@",
+ "force" => 1,
"list" => 1,
- "no-auto-remove" => 1,
"no-auto-install" => 1,
+ "no-auto-remove" => 1,
+ "no-depends" => 1,
+ "no-depends-at-all" => 1,
"reinstall-forcibly-removed" => 1,
- "force" => 1,
- "backupdir" => "=s",
- "backup" => 1,
- "exclude" => "=s@",
- "dry-run|n" => 1
+ "self" => 1,
},
"run-post" => 1,
"function" => \&action_update
@@ -8039,15 +8039,17 @@ A summary of the C<tlmgr pinning> actions is given above.
=head1 GUI FOR TLMGR
-The graphical user interface for C<tlmgr> 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. L<http://tug.org/texlive/distro.html#perltk> has a
-list of invocations for some distros.
+The graphical user interface for C<tlmgr> requires Perl/Tk
+L<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 TL. L<http://tug.org/texlive/distro.html#perltk>
+has a list of invocations for some distros.
-When started with C<tlmgr gui> 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 GUI is started with the invocation C<tlmgr gui>; 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.
Within the main display there are three main parts: the C<Display
configuration> area, the list of packages, and the action buttons.
@@ -8231,6 +8233,42 @@ L<http://tug.org/texlive/doc.html>) and the usual ``About'' box.
=back
+=head2 GUI options
+
+Some generic Perl/Tk options can be specified with C<tlmgr gui> to
+control the display:
+
+=over 4
+
+=item C<-background> I<color>
+
+Set background color.
+
+=item C<-font "> I<fontname> I<fontsize> C<">
+
+Set font, e.g., C<tlmgr gui -font "helvetica 18">. The argument to
+C<-font> must be quoted, i.e., passed as a single string.
+
+=item C<-foreground> I<color>
+
+Set foreground color.
+
+=item C<-geometry> I<geomspec>
+
+Set the X geometry, e.g., C<tlmgr gui -geometry 1024x512-0+0> creates
+the window of (approximately) the given size in the upper-right corner
+of the display.
+
+=item C<-xrm> I<xresource>
+
+Pass the arbitrary X resource string I<xresource>.
+
+=back
+
+A few other obscure options are recognized but not mentioned here. See
+the Perl/Tk documentation (L<http://search.cpan.org/perldoc?Tk>) for the
+complete list, and any X documentation for general information.
+
=head1 MACHINE-READABLE OUTPUT
With the C<--machine-readable> option, C<tlmgr> writes to stdout in the