Bit work on the man page of tlmgr

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

1 files changed, 43 insertions, 42 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index c5c30c374ee..cff5820684c 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -946,9 +946,47 @@ tlmgr - the TeX Live Manager
 
 =head1 SYNOPSIS
 
-tlmgr I<option> I<action> [I<option>]... [I<operand>]...
+tlmgr [I<options>] I<action> [I<option>]... [I<operand>]...
 
-=head1 ACTION
+=head1 DESCRIPTION
+
+B<tlmgr> manages an existing TeX Live installation, both packages and
+options.
+
+=head1 OPTIONS
+
+The following options have to be given I<before> you specify the action.
+
+=over 8
+
+=item B<--location> I<location>
+
+Specifies the location from which packages should be installed or
+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
+
+  tlmgr --gui update
+
+will bring you directly into the update screen.
+
+=item B<--netarchive> I<dir>
+
+Overrides the default settings for netarchive. Should be used with care.
+
+=item B<--diskarchive> I<dir>
+
+Overrides the default settings for diskarchive. Should be used with care.
+
+=back
+
+The standard options B<--help/-h/-?> and B<--debug> are also accepted.
+
+=head1 ACTIONS
 
 =over 8
 
@@ -984,6 +1022,7 @@ written to the terminal.
 
 Updates the packages given as arguments to the latest version available
 at the installation source. Options:
+
 =over 8
 
 =item B<--all>
@@ -1146,12 +1185,12 @@ Options:
 
 =over 8
 
-=item C<--dest> I<output file>
+=item B<--dest> I<output file>
 
 specifies the output file (defaults to the respective location in
 C<TEXMFSYSVAR>).
 
-=item C<--localcfg> I<local conf file>
+=item B<--localcfg> I<local conf file>
 
 specifies the (optional) local additions (defaults to the respective
 location in C<TEXMFSYSVAR>).
@@ -1161,44 +1200,6 @@ location in C<TEXMFSYSVAR>).
 =back
 
 
-=head1 OPTIONS
-
-=over 8
-
-=item B<--location> I<location>
-
-Specifies the location from which packages should be installed or
-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
-
-  tlmgr --gui update
-
-will bring you directly into the update screen.
-
-=item B<--netarchive> I<dir>
-
-Overrides the default settings for netarchive. Should be used with care.
-
-=item B<--diskarchive> I<dir>
-
-Overrides the default settings for diskarchive. Should be used with care.
-
-=back
-
-The standard options C<--help/-h/-?> and C<--debug> are also accepted.
-
-
-=head1 DESCRIPTION
-
-B<tlmgr> manages an existing TeX Live installation, both packages and
-options.
-
-
 =head1 AUTHORS AND COPYRIGHT
 
 This script and its documentation were written for the TeX Live