summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-04-03 23:23:55 +0000
committerKarl Berry <karl@freefriends.org>2019-04-03 23:23:55 +0000
commit791d00052c91e3a1dcc0050c08429065ea730ca9 (patch)
tree9d9ae8b9b551d705f6bd49b0857eb44141d750ac /Master/texmf-dist/doc/man
parentf182c54b24b79780ea8a64058122fb93ca912379 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@50746 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/install-tl.178
-rw-r--r--Master/texmf-dist/doc/man/man1/install-tl.man1.pdfbin49265 -> 49260 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.131
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.man1.pdfbin132742 -> 133086 bytes
4 files changed, 61 insertions, 48 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index d08700070f8..cffbcf6cfad 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.1
+++ b/Master/texmf-dist/doc/man/man1/install-tl.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "INSTALL-TL 1"
-.TH INSTALL-TL 1 "2019-03-01" "perl v5.28.1" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2019-04-03" "perl v5.28.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -185,7 +185,7 @@ leading \f(CW\*(C`\-\*(C'\fR or \f(CW\*(C`\-\-\*(C'\fR. An argument value can b
option by either a space or \f(CW\*(C`=\*(C'\fR.
.IP "\fB\-gui\fR [[=]\fImodule\fR]" 4
.IX Item "-gui [[=]module]"
-If no \fImodule\fR is given, starts the \f(CW\*(C`perltk\*(C'\fR (see below) \s-1GUI\s0 installer.
+If no \fImodule\fR is given, starts the Tcl/Tk (see below) \s-1GUI\s0 installer.
.Sp
If \fImodule\fR is given loads the given installer module. Currently the
following modules are supported:
@@ -195,11 +195,19 @@ following modules are supported:
.IX Item "text"
The text mode user interface (default on Unix systems). Same as the
\&\f(CW\*(C`\-no\-gui\*(C'\fR option.
+.ie n .IP """tcl""" 4
+.el .IP "\f(CWtcl\fR" 4
+.IX Item "tcl"
+The tcl user interface (default on Mac \s-1OS\s0 and Windows). It starts
+out with a small number of configuration options, roughly equivalent
+to what the wizard option below offers, but a button \f(CW\*(C`Advanced\*(C'\fR
+takes you to a screen with roughly the same options as the perltk
+interface.
.ie n .IP """wizard""" 4
.el .IP "\f(CWwizard\fR" 4
.IX Item "wizard"
-The wizard mode user interface (default on Windows), asking only minimal
-questions before installing all of TeX Live.
+The wizard mode user interface, asking only minimal questions before
+installing all of TeX Live.
.ie n .IP """expert""" 4
.el .IP "\f(CWexpert\fR" 4
.IX Item "expert"
@@ -208,40 +216,36 @@ in the future.
.ie n .IP """perltk""" 4
.el .IP "\f(CWperltk\fR" 4
.IX Item "perltk"
-The expert \s-1GUI\s0 installer, providing access to more options.
-Can also be invoked on Windows by running \f(CW\*(C`install\-tl\-advanced.bat\*(C'\fR.
-.ie n .IP """tcl""" 4
-.el .IP "\f(CWtcl\fR" 4
-.IX Item "tcl"
-An experimental \s-1GUI.\s0 It starts out simply, with the same options as
-the wizard installer, but a button 'Advanced' gives access to almost
-all the options of the perltk \s-1GUI.\s0
+The expert \s-1GUI\s0 installer, providing access to more options.
.RE
.RS 4
.Sp
-The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules, and thus also when calling with
-bare \f(CW\*(C`\-gui\*(C'\fR (with no \fImodule\fR), require the Perl/Tk module
-(<https://tug.org/texlive/distro.html#perltk>); if Perl/Tk is not
-available, installation continues in text mode.
+The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules require the Perl/Tk module
+(<https://tug.org/texlive/distro.html#perltk>). if Perl/Tk is not
+available, installation continues in text mode, except on Windows,
+where all gui options except \f(CW\*(C`text\*(C'\fR are diverted to the default
+\&\f(CW\*(C`tcl\*(C'\fR \s-1GUI.\s0
.Sp
-The tcl \s-1GUI\s0 requires Tcl/Tk. This is part of Mac \s-1OS\s0 and is often
+The \f(CW\*(C`tcl\*(C'\fR \s-1GUI\s0 requires Tcl/Tk. This is part of Mac \s-1OS\s0 and is often
already installed on Linux. For Windows, TeX Live provides a Tcl/Tk
runtime.
.RE
.IP "\fB\-no\-gui\fR" 4
.IX Item "-no-gui"
-Use the text mode installer (default except on Windows).
+Use the text mode installer (default except on Windows and Mac \s-1OS\s0).
.IP "\fB\-lang\fR \fIllcode\fR" 4
.IX Item "-lang llcode"
-By default, the \s-1GUI\s0 tries to deduce your language from the environment
-(on Windows via the registry, on Unix via \f(CW\*(C`LC_MESSAGES\*(C'\fR). If that fails
-you can select a different language by giving this option with a
-language code (based on \s-1ISO 639\-1\s0). Currently supported (but not
-necessarily completely translated) are: English (en, default), Czech
-(cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl),
-Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk),
-Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi),
-simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
+By default, the \s-1GUI\s0 tries to deduce your language from the
+environment. The tcl \s-1GUI\s0 uses the language detection built into
+Tcl/Tk; the Perl/Tk GUIs use the \f(CW\*(C`LC_MESSAGES\*(C'\fR environment
+variable. If that fails you can select a different language by
+giving this option with a language code (based on \s-1ISO 639\-1\s0).
+Currently supported (but not necessarily completely translated) are:
+English (en, default), Czech (cs), German (de), French (fr), Italian
+(it), Japanese (ja), Dutch (nl), Polish (pl), Brazilian Portuguese
+(pt_BR), Russian (ru), Slovak (sk), Slovenian (sl), Serbian (sr),
+Ukrainian (uk), Vietnamese (vi), simplified Chinese (zh_CN), and
+traditional Chinese (zh_TW).
.IP "\fB\-repository\fR \fIurl|path\fR" 4
.IX Item "-repository url|path"
Specify the package repository to be used as the source of the
@@ -261,12 +265,12 @@ the full scheme containing all packages, the list of available schemes
will be adjusted accordingly.
.IP "\fB\-select\-repository\fR" 4
.IX Item "-select-repository"
-This option allows you to choose a particular mirror from the current
-list of active \s-1CTAN\s0 mirrors. This option is supported in all installer
-modes (text, wizard, perltk), and will also offer to install from local
-media if available, or from a repository specified on the command line.
-It's useful when the (default) automatic redirection does not choose a
-good host for you.
+This option allows you to choose a particular mirror from the
+current list of active \s-1CTAN\s0 mirrors. This option is supported in the
+text, wizard and perltk installer modes, and will also offer to
+install from local media if available, or from a repository
+specified on the command line. It's useful when the (default)
+automatic redirection does not choose a good host for you.
.IP "\fB\-all\-options\fR" 4
.IX Item "-all-options"
Normally options not relevant to the current platform are not shown
@@ -290,9 +294,9 @@ For more information on custom binaries, see
building TeX Live, see <https://tug.org/texlive/build.html>.
.IP "\fB\-debug\-translation\fR" 4
.IX Item "-debug-translation"
-In \s-1GUI\s0 mode, this options reports any missing, or more likely
-untranslated, messages to standard error. Helpful for translators to see
-what remains to be done.
+In the Perl/Tk \s-1GUI\s0 modes, this options reports any missing, or more
+likely untranslated, messages to standard error. Helpful for
+translators to see what remains to be done.
.IP "\fB\-force\-platform\fR \fIplatform\fR" 4
.IX Item "-force-platform platform"
Instead of auto-detecting the current platform, use \fIplatform\fR.
@@ -606,4 +610,4 @@ This script and its documentation were written for the TeX Live
distribution (<https://tug.org/texlive>) and both are licensed under the
\&\s-1GNU\s0 General Public License Version 2 or later.
.PP
-\&\f(CW$Id:\fR install-tl 50189 2019\-03\-01 23:27:15Z karl $
+\&\f(CW$Id:\fR install-tl 50723 2019\-04\-03 16:04:15Z siepo $
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
index b4638e3099f..2ae4346f40d 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 886f43c36bf..e4d9c0a81c0 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "TLMGR 1"
-.TH TLMGR 1 "2019-02-02" "perl v5.28.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2019-04-03" "perl v5.28.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -317,6 +317,9 @@ example, running
.Sp
starts you directly at the update screen. If no action is given, the
\&\s-1GUI\s0 will be started at the main screen.
+.Sp
+Note that the new GUIs, tlshell and tlcockpit, are started up as
+separate programs.
.IP "\fB\-\-gui\-lang\fR \fIllcode\fR" 4
.IX Item "--gui-lang llcode"
By default, the \s-1GUI\s0 tries to deduce your language from the environment
@@ -328,6 +331,8 @@ necessarily completely translated) are: English (en, default), Czech
Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk),
Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi),
simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
+.Sp
+Tlshell shares its message catalog with tlmgr.
.IP "\fB\-\-debug\-translation\fR" 4
.IX Item "--debug-translation"
In \s-1GUI\s0 mode, this switch tells \f(CW\*(C`tlmgr\*(C'\fR to report any untranslated (or
@@ -1852,16 +1857,20 @@ 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 requires Perl/Tk
-<https://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 <https://tug.org/texlive/distro.html#perltk>
-has a list of invocations for some distros.
+<https://search.cpan.org/search?query=perl%2Ftk>. For Unix-based
+systems Perl/Tk (as well as Perl of course) has to be installed
+outside of \s-1TL.\s0 <https://tug.org/texlive/distro.html#perltk> has a
+list of invocations for some distros. For Windows the necessary
+modules are no longer shipped within TeX Live.
+.PP
+We are talking here about the \s-1GUI\s0 built into tlmgr itself, not about
+the other tlmgr GUIs: tlshell, tlcockpit (Java-based) and, for Mac
+\&\s-1OS\s0 only, TeX Live Utility. These are invoked as separate programs.
.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.
+The \s-1GUI\s0 mode of tlmgr 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.
@@ -2270,4 +2279,4 @@ This script and its documentation were written for the TeX Live
distribution (<https://tug.org/texlive>) and both are licensed under the
\&\s-1GNU\s0 General Public License Version 2 or later.
.PP
-\&\f(CW$Id:\fR tlmgr.pl 49885 2019\-01\-31 19:27:00Z karl $
+\&\f(CW$Id:\fR tlmgr.pl 50722 2019\-04\-03 15:56:51Z siepo $
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index 8fc206a0e66..c3f0a8c78fa 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
Binary files differ