munge doc about -profile to try to make usage clearer.

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

1 files changed, 25 insertions, 19 deletions

diff --git a/Master/install-tl b/Master/install-tl
index b85dd3e28fd..aee16c13f3f 100755
--- a/Master/install-tl
+++ b/Master/install-tl
@@ -2108,25 +2108,31 @@ C<-print-arch> is a synonym.
 
 =item B<-profile> I<profile>
 
-Load the I<profile> file for repeated installations on different systems.
-A I<profile> 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.
-
-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.
-
-There is one exception to this: If the profile contains a variable for
-C<selected_scheme> and I<no> collection variable is defined in the
-profile, then the collections which the specified scheme requires are
-installed.  Thus, a simple line C<selected_scheme scheme-medium>
-together with the definitions of the paths (C<TEXDIR>,
-C<TEXMFHOME>, C<TEXMFLOCAL>, C<TEXMFSYSCONFIG>, C<TEXMFSYSVAR>) suffices
-to install the medium scheme with all default options.
+Load the file I<profile> for repeated installations on different
+systems.  This is useful for batch or scripted installation of TeX Live,
+that is, no user interaction is required.
+
+A I<profile> 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
+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.
+
+Normally a profile has to specify the value C<1> 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
+C<selected_scheme> and I<no> collection variables are defined in the
+profile at all, then the collections which the specified scheme requires
+are installed.
+
+Thus, a line C<selected_scheme scheme-medium> together with the
+definitions of the installation directories (C<TEXDIR>, C<TEXMFHOME>,
+C<TEXMFLOCAL>, C<TEXMFSYSCONFIG>, C<TEXMFSYSVAR>) suffices to install
+the medium scheme with all default options.
 
 =item B<-q>