tl-update-auto

git-svn-id: svn://tug.org/texlive/trunk@44005 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 51 insertions, 46 deletions

diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index 5349d696e04..55974b03100 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.1
+++ b/Master/texmf-dist/doc/man/man1/install-tl.1
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "INSTALL-TL 1"
-.TH INSTALL-TL 1 "2017-04-22" "perl v5.24.1" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2017-04-23" "perl v5.24.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
@@ -146,11 +146,12 @@ install\-tl\-advanced.bat [\fIoption\fR]...
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
 This installer creates a runnable TeX Live installation from various
-media, including over the network.  The installer works across all
-platforms supported by TeX Live.  For information on initially
-downloading the TeX Live, see <http://tug.org/texlive/acquire.html>.
+media, including over the network, from local hard disk, a \s-1DVD,\s0 etc.
+The installer works across all platforms supported by TeX Live.  For
+information on initially downloading the TeX Live, see
+<http://tug.org/texlive/acquire.html>.
 .PP
-The basic idea of TeX Live installation is to choose one of the
+The basic idea of TeX Live installation is for you to choose one of the
 top-level \fIschemes\fR, each of which is defined as a different set of
 \&\fIcollections\fR and \fIpackages\fR, where a collection is a set of packages,
 and a package is what contains actual files.
@@ -158,18 +159,18 @@ and a package is what contains actual files.
 Within the installer, you can choose a scheme, and further customize the
 set of collections to install, but not the set of the packages.  To do
 that, use \f(CW\*(C`tlmgr\*(C'\fR (reference below) after the initial installation is
-completely.
+complete.
 .PP
-The default is \f(CW\*(C`scheme\-full\*(C'\fR, to install everything, and this is highly
-recommended.
+The default is \f(CW\*(C`scheme\-full\*(C'\fR, which installs everything, and this is
+highly recommended.
 .SH "REFERENCES"
 .IX Header "REFERENCES"
 Post-installation configuration, package updates, and much more, are
 handled through \fBtlmgr\fR(1), the TeX Live Manager
 (<http://tug.org/texlive/tlmgr.html>).
 .PP
-The most up-to-date version of this documentation is on the Internet at
-<http://tug.org/texlive/doc/install\-tl.html>.
+The most up-to-date version of this installer documentation is on the
+Internet at <http://tug.org/texlive/doc/install\-tl.html>.
 .PP
 For the full documentation of TeX Live, see
 <http://tug.org/texlive/doc>.
@@ -180,31 +181,31 @@ 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 \f(CW\*(C`perltk\*(C'\fR (see below) \s-1GUI\s0 installer.
 .Sp
 If \fImodule\fR is given loads the given installer module. Currently the
 following modules are supported:
 .RS 4
-.ie n .IP """text""" 8
-.el .IP "\f(CWtext\fR" 8
+.ie n .IP """text""" 4
+.el .IP "\f(CWtext\fR" 4
 .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 """wizard""" 8
-.el .IP "\f(CWwizard\fR" 8
+.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.
-.ie n .IP """perltk""" 8
-.el .IP "\f(CWperltk\fR" 8
+.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.
 .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 a
-bare \f(CW\*(C`\-gui\*(C'\fR (without \fImodule\fR), requires the Perl/Tk module
+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
 (<http://tug.org/texlive/distro.html#perltk>); if Perl/Tk is not
 available, installation continues in text mode.
 .RE
@@ -226,8 +227,9 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
 .IX Item "-repository url|path"
 Specify the package repository to be used as the source of the
 installation, either a local directory via \f(CW\*(C`/path/to/directory\*(C'\fR or a
-\&\f(CW\*(C`file:/\*(C'\fR url, or a network location via a \f(CW\*(C`http://\*(C'\fR or \f(CW\*(C`ftp://\*(C'\fR url.
-(No other protocols are supported.)
+\&\f(CW\*(C`file:/\*(C'\fR url, or a network location via a \f(CW\*(C`http://\*(C'\fR, \f(CW\*(C`https://\*(C'\fR, or
+\&\f(CW\*(C`ftp://\*(C'\fR url.  (No other protocols are supported, and \f(CW\*(C`http://\*(C'\fR may
+not work on all platforms.)
 .Sp
 The default is to pick a mirror automatically, using
 <http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is
@@ -243,7 +245,7 @@ you could choose a particular \s-1CTAN\s0 mirror with something like this:
 \&  \-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
 .Ve
 .Sp
-Of course a real hostname and its particular top-level \s-1CTAN\s0 path
+Of course a real hostname and its particular top-level \s-1CTAN\s0 directory
 have to be specified.  The list of \s-1CTAN\s0 mirrors is available at
 <http://ctan.org/mirrors>.
 .Sp
@@ -275,9 +277,9 @@ 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
-(i.e., when running on Unix, Windows-specific options are omitted).
-Giving this command line option allows configuring settings in the
-final \f(CW\*(C`texlive.tlpdb\*(C'\fR that do not have any immediate effect.
+(e.g., when running on Unix, Windows-specific options are omitted).
+Giving this command line option allows configuring such \*(L"foreign\*(R"
+settings.
 .IP "\fB\-custom\-bin\fR \fIpath\fR" 4
 .IX Item "-custom-bin path"
 If you have built your own set of TeX Live binaries (perhaps because
@@ -287,8 +289,12 @@ the current system are present.  The installation will continue as
 usual, but at the end all files from \fIpath\fR are copied over to
 \&\f(CW\*(C`bin/custom/\*(C'\fR under your installation directory and this \f(CW\*(C`bin/custom/\*(C'\fR
 directory is what will be added to the path for the post-install
-actions.  (By the way, for information on building TeX Live, see
-<http://tug.org/texlive/build.html>).
+actions.  To install multiple custom binary sets, manully rename
+\&\f(CW\*(C`custom\*(C'\fR before doing each.
+.Sp
+For more information on custom binaries, see
+<http://tug.org/texlive/custom\-bin.html>.  For general information on
+building TeX Live, see <http://tug.org/texlive/build.html>.
 .IP "\fB\-debug\-translation\fR" 4
 .IX Item "-debug-translation"
 In \s-1GUI\s0 mode, this switch makes \f(CW\*(C`tlmgr\*(C'\fR report any missing, or more
@@ -301,7 +307,7 @@ Binaries for this platform must be present and they must actually be
 runnable, or installation will fail.  \f(CW\*(C`\-force\-arch\*(C'\fR is a synonym.
 .IP "\fB\-help\fR, \fB\-\-help\fR, \fB\-?\fR" 4
 .IX Item "-help, --help, -?"
-Display this help and exit (on the web via
+Display this help and exit.  (This help is on the web at
 <http://tug.org/texlive/doc/install\-tl.html>).  Sometimes the
 \&\f(CW\*(C`perldoc\*(C'\fR and/or \f(CW\*(C`PAGER\*(C'\fR programs on the system have problems,
 possibly resulting in control characters being literally output.  This
@@ -369,23 +375,21 @@ Load the file \fIprofile\fR and do the installation with no user
 interaction, that is, a batch (unattended) install.
 .Sp
 A \fIprofile\fR file contains all the values needed to perform an
-installation.  From the text menu one can select 'P' to save the
-current setup as profile. Furthermore, after a normal installation
+installation.  From the text menu one can select \f(CW\*(C`P\*(C'\fR to save the
+current setup as profile.  In addition, after a normal installation
 has finished, a profile for that exact installation is written to the file
-DEST/tlpkg/texlive.profile.  That file can be given as the argument to
+\&\f(CW\*(C`tlpkg/texlive.profile\*(C'\fR.  That file can be given as the argument to
 \&\f(CW\*(C`\-profile\*(C'\fR to redo the exact same installation on a different system,
 for example.  Alternatively, you can use a custom profile, most easily
 created by starting from a generated one and changing values, or an
 empty file, which will take all the defaults.
 .Sp
-Normally a profile has to specify the value \f(CW1\fR for each collection to
-be installed, even if the scheme is specified.  This follows from the
-logic of the installer in that you can first select a scheme and then
-change the collections being installed.  But for convenience there is an
-exception to this within profiles: If the profile contains a variable
-for \f(CW\*(C`selected_scheme\*(C'\fR and \fIno\fR collection variables at all are defined
-in the profile, then the collections which the specified scheme requires
-are installed.
+Within a profile file, if the variable \f(CW\*(C`selected_scheme\*(C'\fR is defined and
+\&\fIno\fR collection variables at all are defined, then the collections
+required by the specified scheme are installed, without explicitly
+listing them.  This eases maintenance of profile files.  If any
+collections are specified in a profile, though, then this does not
+apply, and all desired collections must be given explicitly.
 .Sp
 Thus, a line \f(CW\*(C`selected_scheme scheme\-medium\*(C'\fR together with the
 definitions of the installation directories (\f(CW\*(C`TEXDIR\*(C'\fR, \f(CW\*(C`TEXMFHOME\*(C'\fR,
@@ -397,8 +401,8 @@ For more detailed explanations on the meaning of the options
 consult the TeX Live installation manual. Values are either
 \&\f(CW0\fR, \f(CW1\fR, or strings.
 .RS 4
-.ie n .IP "\fBinstaller options\fR (those with prefix ""instopt_"")" 8
-.el .IP "\fBinstaller options\fR (those with prefix \f(CWinstopt_\fR)" 8
+.ie n .IP "\fBinstaller options\fR (those with prefix ""instopt_"")" 4
+.el .IP "\fBinstaller options\fR (those with prefix \f(CWinstopt_\fR)" 4
 .IX Item "installer options (those with prefix instopt_)"
 \&\f(CW\*(C`instopt_portable\*(C'\fR (default 0, see \f(CW\*(C`\-portable\*(C'\fR), 
 \&\f(CW\*(C`instopt_letter\*(C'\fR (default 0, selecting letter size instead of a4), 
@@ -407,8 +411,8 @@ mirror after installation),
 \&\f(CW\*(C`instopt_write18_restricted\*(C'\fR (default 1, enable write8 for a restricted
 set of programs),
 \&\f(CW\*(C`instopt_adjustpath\*(C'\fR (default 0 on Unix, 1 on Windows, adjust \s-1PATH\s0 environment).
-.ie n .IP "\fBtlpdb options\fR (those with prefix ""tlpdbopt_"")" 8
-.el .IP "\fBtlpdb options\fR (those with prefix \f(CWtlpdbopt_\fR)" 8
+.ie n .IP "\fBtlpdb options\fR (those with prefix ""tlpdbopt_"")" 4
+.el .IP "\fBtlpdb options\fR (those with prefix \f(CWtlpdbopt_\fR)" 4
 .IX Item "tlpdb options (those with prefix tlpdbopt_)"
 The definitive list is give in \f(CW\*(C`TeXLive::TLConfig.pm\*(C'\fR in 
 \&\f(CW%TeXLive::TLConfig::TLPDBOptions\fR, together with explanations.
@@ -420,12 +424,12 @@ The current list is given below:
 \&\f(CW\*(C`tlpdbopt_install_srcfiles\*(C'\fR, \f(CW\*(C`tlpdbopt_post_code\*(C'\fR, 
 \&\f(CW\*(C`tlpdbopt_sys_bin\*(C'\fR, \f(CW\*(C`tlpdbopt_sys_info\*(C'\fR, \f(CW\*(C`tlpdbopt_sys_man\*(C'\fR, 
 \&\f(CW\*(C`tlpdbopt_w32_multi_user\*(C'\fR, \f(CW\*(C`tlpdbopt_generate_updmap\*(C'\fR
-.IP "\fBpath options\fR" 8
+.IP "\fBpath options\fR" 4
 .IX Item "path options"
 \&\f(CW\*(C`TEXDIR\*(C'\fR, \f(CW\*(C`TEXMFHOME\*(C'\fR, \f(CW\*(C`TEXMFCONFIG\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR,
 \&\f(CW\*(C`TEXMFVAR\*(C'\fR, \f(CW\*(C`TEXMFSYSVAR\*(C'\fR, \f(CW\*(C`TEXMFLOCAL\*(C'\fR
-.ie n .IP "\fBarchitecture selection options\fR (those starting with ""binary_"")" 8
-.el .IP "\fBarchitecture selection options\fR (those starting with \f(CWbinary_\fR)" 8
+.ie n .IP "\fBarchitecture selection options\fR (those starting with ""binary_"")" 4
+.el .IP "\fBarchitecture selection options\fR (those starting with \f(CWbinary_\fR)" 4
 .IX Item "architecture selection options (those starting with binary_)"
 For every supported architecture of TeX Live (directories under
 \&\f(CW\*(C`bin/\*(C'\fR), the key \f(CW\*(C`binary_ARCH\*(C'\fR can be set.
@@ -518,3 +522,4 @@ Don't try to run the \f(CW\*(C`\-\-help\*(C'\fR message through \f(CW\*(C`perldo
 This script and its documentation were written for the TeX Live
 distribution (<http://tug.org/texlive>) and both are licensed under the
 \&\s-1GNU\s0 General Public License Version 2 or later.
+\&\f(CW$Id\fR$
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 e7861af46f7..146b2efee64 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf