some (incomplete) help formatting, for the sake of

http://tug.org/texlive/tlmgr.html, although
pod2html is apparently sadly insufficient.


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

1 files changed, 25 insertions, 24 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 80859c5e7c9..0c0ca5b4cf8 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -1247,7 +1247,9 @@ tlmgr [I<option>]... I<action> [I<option>]... [I<operand>]...
 =head1 DESCRIPTION
 
 B<tlmgr> manages an existing TeX Live installation, both packages and
-configurations options.
+configuration options.  It performs many of the same actions as
+B<texconfig>(1), and more besides.  (texconfig continues to included and
+supported, but tlmgr is now preferred.)
 
 =head1 OPTIONS
 
@@ -1262,9 +1264,8 @@ updated, overriding the location found in the installation's TLPDB.
 
 =item B<--gui>
 
-Instead of starting the GUI via the B<gui> action, you can also give this
-option together with an action from above and will be brought directly
-into the respective screen of the GUI. So calling
+You can give this option together with an action to be brought directly
+into the respective screen of the GUI.  For example, calling
 
   tlmgr --gui update
 
@@ -1281,7 +1282,7 @@ language code.
 
 The standard options are also accepted: B<--help/-h/-?>, B<--version>,
 B<-q> (no informational messages), B<-v> (debugging messages, can be
-repeated).  For more information about the latter, see the
+repeated).  For the details about the latter, see the
 TeXLive::TLUtils documentation.
 
 =head1 ACTIONS
@@ -1296,16 +1297,16 @@ Gives this help page.
 
 Start the graphical user interface.
 
-=item B<install [I<option>]... I<pkg>...>
+=item B<install> [I<option>]... I<pkg>...
 
 Install all I<pkg>s given on the command line. By default this installs
 all packages that the given I<pkg>s are dependent on, also.  Options:
 
-=over 8
+=over 16
 
 =item B<--no-depends>
 
-Do not install dependencies.  Bydefault, installing a package ensures
+Do not install dependencies.  By default, installing a package ensures
 that all dependencies of this package are fulfilled.
 
 =item B<--dry-run>
@@ -1316,7 +1317,7 @@ written to the terminal.
 =back
 
 
-=item B<update [I<option>] [pkg [pkg ...]]>
+=item B<update> [I<option>] [I<pkg>...]
 
 Updates the packages given as arguments to the latest version available
 at the installation source. Options:
@@ -1336,7 +1337,7 @@ Update all package.
 Nothing is actually installed; instead, the actions to be performed are
 written to the terminal.
 
-=item B<--backupdir directory>
+=item B<--backupdir> I<directory>
 
 If this option is given it must specify an existing directory where a 
 snapshot of the current package as installed will be saved before 
@@ -1345,7 +1346,7 @@ turned out as not working. See the action B<restore> for details.
 
 =back
 
-=item B<backup --backupdir dir [--all] [pkg [pkg]]>
+=item B<backup> --backupdir I<dir> [B<--all>] [I<pkg>...]
 
 Makes a backup of the given packages (or all packages with B<--all>) to
 the directory specified with B<--backupdir> (must exist and be a writable).
@@ -1357,31 +1358,31 @@ Options:
 
 =over 8
 
-=item B<--backupdir directory>
+=item B<--backupdir> I<directory>
 
-This is an obligatory argument and has to specify a directory where
-backups are to be found.
+The I<directory> is an obligatory argument and has to specify a
+directory where backups are to be found.
 
 =item B<--all>
 
-Make a backup of all packages in the texlive.tlpdb
+Make a backup of all packages in the TeX Live installation.
 
 =back
 
 
-=item B<restore --backupdir dir [pkg [rev]]>
+=item B<restore --backupdir> I<dir> [I<pkg> [I<rev>]]
 
-If no B<pkg> and B<rev> is given list all packages the available 
-backup revisions.
+If no I<pkg> and I<rev> is given, list the available 
+backup revisions for all packages.
 
-With B<pkg> given but without B<rev> lists all available backup revisions
-of B<pkg>.
+With I<pkg> given but no I<rev>, list all available backup revisions of
+I<pkg>.
 
-With both B<pkg> an B<rev> given tries to restore the package from its
-backup.
+With both I<pkg> and I<rev>, tries to restore the package from the
+specified backup.
 
-The option B<--backupdir dir> is obligatory and has to specify a directory
-with backups.
+The option B<--backupdir> I<dir> is obligatory and has to specify a
+directory with backups.
 
 Options: