From 706e437fe3277b510cd1a935f155e88b26fb5233 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 14 Apr 2013 18:42:14 +0000 Subject: doc changes for user mode, etc. git-svn-id: svn://tug.org/texlive/trunk@29915 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/scripts/texlive/tlmgr.pl | 236 ++++++++++++++--------------- 1 file changed, 117 insertions(+), 119 deletions(-) (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl index 05017552c36..36937fd12fd 100755 --- a/Master/texmf-dist/scripts/texlive/tlmgr.pl +++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl @@ -126,16 +126,16 @@ sub main { "gui" => 1, "gui-lang" => "=s", "debug-translation" => 1, - "location|repository|repo" => "=s", + "repository|repo|location" => "=s", "machine-readable" => 1, + "no-execute-actions" => 1, "package-logfile" => "=s", "persistent-downloads" => "!", - "no-execute-actions" => 1, - "pin-file" => "=s", "pause" => 1, - "usermode" => 1, - "usertree" => "=s", + "pin-file" => "=s", "print-platform|print-arch" => 1, + "usermode|user-mode" => 1, + "usertree|user-tree" => "=s", "version" => 1, "help" => 1, "h|?" => 1); @@ -481,7 +481,7 @@ sub give_version { # # add the list of revisions if ($::opt_verbosity > 0) { - $::version_string .= "Revision of modules:"; + $::version_string .= "Revisions of TeXLive:: modules:"; $::version_string .= "\nTLConfig: " . TeXLive::TLConfig->module_revision(); $::version_string .= "\nTLUtils: " . TeXLive::TLUtils->module_revision(); $::version_string .= "\nTLPOBJ: " . TeXLive::TLPOBJ->module_revision(); @@ -613,7 +613,7 @@ sub execute_action { # close the special log file if ($packagelogfile && !$::gui_mode) { - info("tlmgr: package log updated at $packagelogfile\n") if $packagelogged; + info("$prg: package log updated: $packagelogfile\n") if $packagelogged; close(PACKAGELOG); } @@ -5933,7 +5933,7 @@ C has more details about this C<--repository> changes the repository location only for the current run; to make a permanent change, use C action). For backward compatibility and convenience, C<--location> and C<--repo> are accepted as aliases for this option. @@ -5941,14 +5941,14 @@ are accepted as aliases for this option. =item B<--gui> [I] -C has a graphical interface as well as the command-line +C has a graphical interface as well as the command line interface. You can give this option, C<--gui>, together with an action to be brought directly into the respective screen of the GUI. For example, running tlmgr --gui update -starts you directly at the update screen. Without any action, the +starts you directly at the update screen. If no action is given, the GUI will be started at the main screen. =for comment Keep language list in sync with install-tl. @@ -5965,12 +5965,24 @@ Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk), Slovenian (sl), Serbian (sr), Vietnamese (vi), simplified Chinese (zh_CN), and traditional Chinese (zh_TW). +=item B<--debug-translation> + +In GUI mode, this switch tells C to report any untranslated (or +missing) messages to standard error. This can help translators to see +what remains to be done. + =item B<--machine-readable> Instead of the normal output intended for human consumption, write (to standard output) a fixed format more suitable for machine parsing. See the L section below. +=item B<--no-execute-actions> + +Suppress the execution of the execute actions as defined in the tlpsrc +files. Documented only for completeness, as this is only useful in +debugging. + =item B<--package-logfile> I C logs all package actions (install, remove, update, failed @@ -5988,45 +6000,39 @@ Windows to avoid disappearing command windows. =item B<--no-persistent-downloads> For network-based installations, this option (on by default) makes -C try to set up a persistent connection (using the L -Perl module). The idea is to open and reuse only one connection per -session between your computer and the server, instead of initiating a -new download for each package. +C try to set up a persistent connection (using the C Perl +module). The idea is to open and reuse only one connection per session +between your computer and the server, instead of initiating a new +download for each package. If this is not possible, C will fall back to using C. To disable these persistent connections, use C<--no-persistent-downloads>. -=item B<--no-execute-actions> +=item B<--pin-file> -Suppress the execution of the execute actions as defined in the tlpsrc -files. Documented only for completeness, as this is only useful in -debugging. - -=item B<--debug-translation> - -In GUI mode, this switch makes C report any missing, or more -likely untranslated, messages to standard error. This can help -translators to see what remains to be done. +Change the pinning file location from C +(see L below). Documented only for completeness, as this is +only useful in debugging. =item B<--usermode> -Activates the user mode, see L below. +Activates user mode for this run of C; see L below. =item B<--usertree> I -Uses I as user tree in user mode, seel L below. - +Uses I for the tree in user mode; see L below. =back The standard options for TeX Live programs are also accepted: C<--help/-h/-?>, C<--version>, C<-q> (no informational messages), C<-v> (debugging messages, can be repeated). For the details about these, see -the L documentation. +the C documentation. The C<--version> option shows version information about the TeX Live -release and about the C script itself. If C<-v> is given as -well, revision number for the used TeX Live Perl modules are shown, too. +release and about the C script itself. If C<-v> is also given, +revision number for the loaded TeX Live Perl modules are shown, too. + =head1 ACTIONS @@ -6376,6 +6382,13 @@ L below for details. =back +=head2 init-usertree + +Sets up a texmf tree for so-called user mode management, either the +default user tree (C), or one specified on the command line +with C<--usertree>. See L below. + + =head2 install [I