From 43d037e2d59993148898809f33d60fb77dbeb869 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 18 May 2016 18:00:35 +0000 Subject: gui doc git-svn-id: svn://tug.org/texlive/trunk@41236 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/scripts/texlive/tlmgr.pl | 106 ++++++++++++++++++++--------- 1 file changed, 72 insertions(+), 34 deletions(-) (limited to 'Master/texmf-dist/scripts') 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 actions is given above. =head1 GUI FOR TLMGR -The graphical user interface for C 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 has a -list of invocations for some distros. +The graphical user interface for C requires Perl/Tk +L. 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 +has a list of invocations for some distros. -When started with C 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; 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 area, the list of packages, and the action buttons. @@ -8231,6 +8233,42 @@ L) and the usual ``About'' box. =back +=head2 GUI options + +Some generic Perl/Tk options can be specified with C to +control the display: + +=over 4 + +=item C<-background> I + +Set background color. + +=item C<-font "> I I C<"> + +Set font, e.g., C. The argument to +C<-font> must be quoted, i.e., passed as a single string. + +=item C<-foreground> I + +Set foreground color. + +=item C<-geometry> I + +Set the X geometry, e.g., C creates +the window of (approximately) the given size in the upper-right corner +of the display. + +=item C<-xrm> I + +Pass the arbitrary X resource string I. + +=back + +A few other obscure options are recognized but not mentioned here. See +the Perl/Tk documentation (L) for the +complete list, and any X documentation for general information. + =head1 MACHINE-READABLE OUTPUT With the C<--machine-readable> option, C writes to stdout in the -- cgit v1.2.3