/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

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

1 files changed, 30 insertions, 18 deletions

diff --git a/Master/texmf/doc/man/man1/install-tl.1 b/Master/texmf/doc/man/man1/install-tl.1
index d7464a1894f..b97419ed109 100644
--- a/Master/texmf/doc/man/man1/install-tl.1
+++ b/Master/texmf/doc/man/man1/install-tl.1
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "INSTALL-TL 1"
-.TH INSTALL-TL 1 "2011-04-24" "perl v5.12.3" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2011-05-13" "perl v5.12.3" "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
@@ -332,25 +332,31 @@ Print the TeX Live identifier for the detected platform
 \&\f(CW\*(C`\-print\-arch\*(C'\fR is a synonym.
 .IP "\fB\-profile\fR \fIprofile\fR" 4
 .IX Item "-profile profile"
-Load the \fIprofile\fR file for repeated installations on different systems.
-A \fIprofile\fR contains the values of all necessary variable for the
-installation. After normal installation has finished a profile for that
-exact installation is written into DEST/tlpkg/texlive.profile. That file
-can be used to do the exact same installation on a different computer.
+Load the file \fIprofile\fR for repeated installations on different
+systems.  This is useful for batch or scripted installation of TeX Live,
+that is, no user interaction is required.
 .Sp
-You can also hand-craft such a profile starting from a generated one
-by changing some values. Normally a profile has to contain the value 1 for
-each collection that should be installed, even if the scheme is specified.
-That follows from the logic of the installer that you first select a scheme
-and then can change the actual collections being installed.
+A \fIprofile\fR file contains all the values needed to perform an
+installation.  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`\-profile) to redo the exact same installation on a different system,
+of rexample.  Alternatively, you can create a custom profile by starting
+from a generated one and changing values.\*(C'\fR
 .Sp
-There is one exception to this: If the profile contains a variable for
-\&\f(CW\*(C`selected_scheme\*(C'\fR and \fIno\fR collection variable is defined in the
-profile, then the collections which the specified scheme requires are
-installed.  Thus, a simple line \f(CW\*(C`selected_scheme scheme\-medium\*(C'\fR
-together with the definitions of the paths (\f(CW\*(C`TEXDIR\*(C'\fR,
-\&\f(CW\*(C`TEXMFHOME\*(C'\fR, \f(CW\*(C`TEXMFLOCAL\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR, \f(CW\*(C`TEXMFSYSVAR\*(C'\fR) suffices
-to install the medium scheme with all default options.
+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 there is one exception to
+this, for convenience: If the profile contains a variable for
+\&\f(CW\*(C`selected_scheme\*(C'\fR and \fIno\fR collection variables are defined in the
+profile at all, then the collections which the specified scheme requires
+are installed.
+.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,
+\&\f(CW\*(C`TEXMFLOCAL\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR, \f(CW\*(C`TEXMFSYSVAR\*(C'\fR) suffices to install
+the medium scheme with all default options.
 .IP "\fB\-q\fR" 4
 .IX Item "-q"
 Omit normal informational messages.
@@ -379,3 +385,9 @@ arguments can be separated from their options by either a space or \f(CW\*(C`=\*
 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.
+.SH "POD ERRORS"
+.IX Header "POD ERRORS"
+Hey! \fBThe above document had some coding errors, which are explained below:\fR
+.IP "Around line 2115:" 4
+.IX Item "Around line 2115:"
+Unterminated C<...> sequence