summaryrefslogtreecommitdiff
path: root/Master/install-tl
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-05-12 23:32:30 +0000
committerKarl Berry <karl@freefriends.org>2011-05-12 23:32:30 +0000
commit9dada4e407f185b876220b8841ce85f353d116f8 (patch)
tree7aabc3b2cdcd3c829afb9815df69b6ee88bc0dc0 /Master/install-tl
parenta5001941ec5a8946eacf97a854879431b260abaf (diff)
munge doc about -profile to try to make usage clearer.
git-svn-id: svn://tug.org/texlive/trunk@22447 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/install-tl')
-rwxr-xr-xMaster/install-tl44
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>