Group options by purpose and add sub-headlines for each group.

The urpmi tools share a lot of options like download options, media
selections and so on. Other option groups are package selection,
output options (for urpmf, urpmq) and database options. Grouping them
makes it easier for the user to spot what she needs.

Additionally tool-specific groups will be put near the top of the
options section, while common groups will be put near the end of that
list, followed by rarely used stuff like debugging. This makes it easier
for the user to spot the tool-specific parts.

Grouping may not be perfect and some option may be in a group not
matching 100 percent. But anyway this should be a fairly good state.
followed

1 files changed, 40 insertions, 32 deletions

diff --git a/pod/8/urpmi.update.pod b/pod/8/urpmi.update.pod
index 134ef97a..cd059646 100644
--- a/pod/8/urpmi.update.pod
+++ b/pod/8/urpmi.update.pod
@@ -24,25 +24,10 @@ Force update of GPG key.
 Don't update media, but mark them as ignored (that is, disables them).
 B<--no-ignore> has the reverse behaviour: it marks the media as enabled.
 
-=item B<--limit-rate I<rate>>
-
-Try to limit the download speed, I<rate> is given in bytes/sec. This
-option is not active by default.
-
 =item B<--no-md5sum>
 
 Disable MD5SUM file checking.
 
-=item B<--proxy> I<proxyhost[:port|1080]>
-
-Use specified HTTP proxy.
-
-=item B<--proxy-user> I<user:password>
-
-Use specified user and password to use for proxy authentication.
-Specifying B<--proxy-user=ask> will cause urpmi.update to prompt for a
-username and a password.
-
 =item B<--urpmi-root> I<directory>
 
 Use the file system tree rooted for urpmi database and rpm install. Contrary
@@ -56,6 +41,37 @@ If the urpmi or rpm db is busy, wait until it is available
 
 Use only update media.
 
+=item B<-a>
+
+Select all enabled non-static media to update them.
+
+=item B<-f>
+
+Force updating synthesis
+
+=item B<-ff>
+
+Really force updating synthesis
+
+=item B<--probe-rpms>
+
+Do not use synthesis, use rpm files directly
+
+=item B<-q>
+
+Quiet mode.
+
+=item B<-v>
+
+Verbose mode.
+
+
+=back
+
+=head2 Download Options
+
+=over
+
 =item B<--curl>
 
 Use curl for downloading distant
@@ -78,29 +94,21 @@ them with spaces and enclose them in quotes.
 
 Note that the rsync options will also be used for ssh media.
 
-=item B<-a>
-
-Select all enabled non-static media to update them.
-
-=item B<-f>
-
-Force updating synthesis
-
-=item B<-ff>
-
-Really force updating synthesis
+=item B<--proxy> I<proxyhost[:port|1080]>
 
-=item B<--probe-rpms>
+Use specified HTTP proxy.
 
-Do not use synthesis, use rpm files directly
+=item B<--proxy-user> I<user:password>
 
-=item B<-q>
+Use specified user and password to use for proxy authentication.
+Specifying B<--proxy-user=ask> will cause urpmi.update to prompt for a
+username and a password.
 
-Quiet mode.
+=item B<--limit-rate I<rate>>
 
-=item B<-v>
+Try to limit the download speed, I<rate> is given in bytes/sec. This
+option is not active by default.
 
-Verbose mode.
 
 =back