diff options
author | Karl Berry <karl@freefriends.org> | 2016-05-18 18:00:35 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-05-18 18:00:35 +0000 |
commit | 43d037e2d59993148898809f33d60fb77dbeb869 (patch) | |
tree | c147b28e67858d59efee8ddf05b6e722cf656750 /Master/texmf-dist/scripts | |
parent | 018d361b550e9ae72dcbf31acb6e614bf3a137fc (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-x | Master/texmf-dist/scripts/texlive/tlmgr.pl | 106 |
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 |