doc fixes

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

1 files changed, 31 insertions, 30 deletions

diff --git a/Master/install-tl b/Master/install-tl
index f8acda0b911..571c167c205 100755
--- a/Master/install-tl
+++ b/Master/install-tl
@@ -1892,16 +1892,16 @@ install-tl - TeX Live cross-platform installer
 
 =head1 SYNOPSIS
 
-install-tl [OPTION]...
+install-tl [I<option>]...
 
-install-tl.bat [OPTION]...
+install-tl.bat [I<option>]...
 
 =head1 DESCRIPTION
 
-The TeX Live installer works across all supported platforms and allows
-to install TeX Live from various media, including the network.  For
-information on initially downloading TeX Live, see
-L<http://tug.org/texlive/acquire.html>.
+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 L<http://tug.org/texlive/acquire.html>.
 
 The basic idea of TeX Live installation is to choose one of the
 top-level I<schemes>, each of which is defined as a different set of
@@ -1910,16 +1910,16 @@ 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, remove the undesired packages after installation with C<tlmgr>
-(see reference below).  
+that, use C<tlmgr> (reference below) after the initial installation is
+completely.
 
 The default is C<scheme-full>, to install everything, and this is highly
-recommended unless your disk space is severely limited.
+recommended.
 
 =head1 REFERENCES
 
-Post-installation configuration, packages updates, and more, are handled
-through B<tlmgr>(1), the TeX Live Manager
+Post-installation configuration, package updates, and much more, are
+handled through B<tlmgr>(1), the TeX Live Manager
 (L<http://tug.org/texlive/tlmgr.html>).
 
 The most up-to-date version of this documentation is on the Internet at
@@ -1969,16 +1969,16 @@ Perl/Tk is not available, installation continues in text mode.
 
 Use the text mode installer (default except on Windows).
 
-=item B<-lang> I<2-letter lang code>
+=item B<-lang> I<llcode>
 
 (only for GUI installer) If possible, start the installer translated into
 the language specified by the 2-letter (ISO 639-1) language code (with
 the exception for selecting simplified or traditional Chinese). 
 Currently supported
 languages: English (en, default), Czech (cs), German (de), French (fr), 
-Italian (it), Dutch (nl), Polish (pl), Russian (ru), Slovak (sk), 
-Slovenian (sl), Vietnamese (vi), simplified Chinese (zh-cn), and 
-traditional Chinese (zh-tw).
+Italian (it), Dutch (nl), Polish (pl), Russian (ru), Slovak (sk),
+Slovenian (sl), Serbian (sr), Vietnamese (vi), simplified Chinese
+(zh-cn), and traditional Chinese (zh-tw).
 
 =item B<-repository> I<url|path>
 
@@ -2019,11 +2019,6 @@ will be adjusted accordingly.
 For backward compatibility and convenience, C<--location> and C<--repo>
 are accepted as aliases for this option.
 
-=item B<-no-cls>
-
-(only for text mode installer) do not clear the screen when entering
-a new menu (for debugging purposes).
-
 =item B<-all-options>
 
 Normally options not regarding the current platform are not shown.
@@ -2066,6 +2061,11 @@ Instead of auto-detecting the current platform, use I<platform>.
 Binaries for this platform must be present and they must actually be
 runnable, or installation will fail.  C<-force-arch> is a synonym.
 
+=item B<-no-cls>
+
+(only for text mode installer) do not clear the screen when entering
+a new menu (for debugging purposes).
+
 =item B<-non-admin>
 
 For Windows only: configure for the current user, not for all users.
@@ -2081,15 +2081,14 @@ per session and reuses it, instead of initiating a new download for
 each package.  
 
 This option is turned on by default, and the installation program will
-fall back to using wget if this is not possible. If you want to disable 
-usage of LWP and persistent connections, please use
-B<--no-persistent-downloads>.
+fall back to using C<wget> if this is not possible.  To disable usage of
+LWP and persistent connections, use C<--no-persistent-downloads>.
 
 =item B<-portable>
 
 Install for portable use. This option minimazes the impact on the host 
 system making TeX Live self-contained in a single directory and 
-usable from portable drives. See also section B<PORTABLE USE> below.
+usable from portable drives. See section B<PORTABLE USE> below.
 
 =item B<-print-platform>
 
@@ -2112,7 +2111,7 @@ 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
-B<selected_scheme> and I<no> collection variable is defined in the
+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<TEXDIRW>,
@@ -2150,11 +2149,13 @@ arguments can be separated from their options by either a space or C<=>.
 
 =head1 PORTABLE USE
 
-The TeX Live root directory contains a shell script C<tl-portable>
-and a DOS batch file C<tl-portable.bat> which start up a new shell and
-command prompt, respectively, in which TeX Live can be run with minimal 
-impact on the host system. When running from non-writable medium some 
-minimal preparation of the host system is done on the first run.
+The root directory of a TeX Live installation contains a shell script
+C<tl-portable> and a DOS batch file C<tl-portable.bat> which start up a
+new shell (command prompt), in which TeX Live can be run self-contained.
+
+When running these scripts from a non-writable medium, some preparation
+of the host system is done on the first run, in the host directory
+C<~/.tlportableYYYY>.  Otherwise, the host system is not touched.
 
 =head1 AUTHORS AND COPYRIGHT