Small manpage updates

4 files changed, 55 insertions, 50 deletions

diff --git a/pod/rurpmi.8.pod b/pod/rurpmi.8.pod
index 03957cda..aa13f113 100644
--- a/pod/rurpmi.8.pod
+++ b/pod/rurpmi.8.pod
@@ -9,12 +9,13 @@ rurpmi - restricted urpmi
 =head1 DESCRIPTION
 
 rurpmi is similar to urpmi, but has a stripped-down set of features. It's
-intended to be used by users with sudo rights on it, preventing them to
-abuse it to compromise the system. With it, you can't install arbitrary
-rpm files, the B<--keep>, B<--verify-rpm>, and B<--norebuild> options are
-forced, and several dangerous options are forbidden (B<--root>,
-B<--use-distrib>, B<--env>, B<--nolock>, B<--allow-nodeps>,
-B<--allow-force>, B<--force>).
+intended to be used by users without root privileges but with sudo rights
+on it, preventing any abuse of this tool to compromise the system.
+
+With rurpmi, you can't install arbitrary rpm files; moreoever the
+B<--keep>, B<--verify-rpm>, and B<--norebuild> options are forced, and
+several dangerous options are forbidden (B<--root>, B<--use-distrib>,
+B<--env>, B<--nolock>, B<--allow-nodeps>, B<--allow-force>, B<--force>).
 
 =head1 CAVEAT
 
@@ -32,4 +33,4 @@ Maintained by Rafael Garcia-Suarez,
 
 =head1 SEE ALSO
 
-L<I<urpmi>(8)>.
+urpmi(8).
diff --git a/pod/urpme.8.pod b/pod/urpme.8.pod
index 4ce455a2..e7810263 100644
--- a/pod/urpme.8.pod
+++ b/pod/urpme.8.pod
@@ -19,19 +19,19 @@ If you want to specify packages more broadly, use the B<-a> option.
 
 =item B<--help>
 
-Prints a help message and exit (this is the same as B<-h> or B<-?>). 
+Prints a help message and exit (this is the same as B<-h> or B<-?>).
 
 =item B<-a>
 
-If multiple packages match the given substring, deinstall them all. 
+If multiple packages match the given substring, deinstall them all.
 
 =item B<-v>
 
-Proposes a verbose mode with various messages. 
+Proposes a verbose mode with various messages.
 
 =item B<--auto>
 
-Removes packages non-interactively, without asking questions. 
+Removes packages non-interactively, without asking questions.
 
 =item B<--test>
 
@@ -39,7 +39,7 @@ Test deinstallation of packages but do not modify the system.
 
 =item B<--force>
 
-Force invocation even if some packages do not exist. 
+Force invocation even if some packages do not exist.
 
 =item B<--parallel> I<alias>
 
@@ -48,7 +48,7 @@ that urpmi is installed, but it is not necessary to have media defined on
 any machines). I<alias> defines which extension module is to be used by
 urpmi (currently, B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh> are
 available) and which machines should be updated. This alias is defined in
-the file F</etc/urpmi/parallel.cfg> as described below. 
+the file F</etc/urpmi/parallel.cfg> as described below.
 
 =item B<--root> I<directory>
 
@@ -71,9 +71,15 @@ See urpmi.files(5).
 
 =over
 
+=item 0
+
+Success; or nothing was found to remove; or the user cancelled the whole
+operation.
+
 =item 1
 
-Command line inconsistency. 
+Command line inconsistency, invocation failure (you are not root), or
+packages not found.
 
 =item 2
 
@@ -89,4 +95,4 @@ Pascal Rigaux, Francois Pons, Rafael Garcia-Suarez
 =head1 SEE ALSO
 
 urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
-urpmi(8), urpmq(8), urpmi.files(5). 
+urpmi(8), urpmq(8), urpmi.files(5).
diff --git a/pod/urpmi.files.5.pod b/pod/urpmi.files.5.pod
index d11385e9..54382b01 100644
--- a/pod/urpmi.files.5.pod
+++ b/pod/urpmi.files.5.pod
@@ -12,20 +12,20 @@ media). This manual page documents them.
 
 =over
 
-=item I</var/lib/urpmi/list.<media_name>>
+=item I<< /var/lib/urpmi/list.<media_name> >>
 
 Contains the list of all packages known by urpmi and their location. This
 file is used when a password is used to access a distant location (using
 a network protocol) or when various directories are used to store the
 packages. That's why it's not world-readable.
 
-=item I</var/lib/urpmi/hdlist.<media_name>.cz>
+=item I<< /var/lib/urpmi/hdlist.<media_name>.cz >>
 
 Contains information about all known packages; it's a summary of rpm
 headers. If an hdlist file is used for a medium, B<urpmf> can operate
 completely without accessing this medium (this is almost always the case).
 
-=item I</var/lib/urpmi/synthesis.hdlist.<media_name>.cz>
+=item I<< /var/lib/urpmi/synthesis.hdlist.<media_name>.cz >>
 
 Contains synthesis information about all known packages built from hdlist
 files that can be used by minimal closure algorithm. If these files are
@@ -34,8 +34,7 @@ not present, hdlist files will be used instead to resolve dependencies
 
 =item I</etc/urpmi/urpmi.cfg>
 
-Contains media descriptions.
-See urpmi.cfg(5).
+Contains media descriptions. See urpmi.cfg(5).
 
 =item I</etc/urpmi/proxy.cfg>
 
diff --git a/pod/urpmi.update.8.pod b/pod/urpmi.update.8.pod
index b3545fce..186d8dc5 100644
--- a/pod/urpmi.update.8.pod
+++ b/pod/urpmi.update.8.pod
@@ -9,71 +9,70 @@ urpmi.update - Updates package lists for specified media
 =head1 DESCRIPTION
 
 urpmi.update scans the specified urpmi media to update their package list.
-<I<names>> is a list of names you first told to urpmi.addmedia. 
+<I<names>> is a list of names you first told to urpmi.addmedia.
 
 =head1 OPTIONS
 
 =over
 
-=item B<--wget>
-
-Use wget for downloading distant files. By default curl
-is used if available, or wget instead.
-
 =item B<--curl>
 
 Use curl for downloading distant
 files. By default curl is used if available, or wget instead.
 
+=item B<--force-key>
+
+Force update of GPG key.
+
+=item B<--ignore>, B<--no-ignore>
+
+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<--norebuild>
+
+Don't try to rebuild the hdlist files from the RPMs if the original hdlist
+wasn't readable or was corrupted.
+
 =item B<--proxy> I<proxyhost[:port|1080]>
 
-Use specified HTTP proxy. 
+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. 
+username and a password.
 
 =item B<--update>
 
-Use only update media. 
-
-=item B<--no-md5sum>
-
-Disable MD5SUM file checking. 
-
-=item B<--force-key>
-
-Force update of GPG key. 
+Use only update media.
 
-=item B<--norebuild>
-
-Don't try to rebuild the hdlist files from the RPMs if the original hdlist
-wasn't readable or was corrupted. 
-
-=item B<--ignore>, B<--no-ignore>
+=item B<--wget>
 
-Don't update media, but mark them
-as ignored (disables them). B<--no-ignore> has the reverse behaviour: it marks
-the media as enabled. 
+Use wget for downloading distant files. By default curl
+is used if available, or wget instead.
 
 =item B<-a>
 
-Select all media that are not using a removable device to update them. 
+Select all media that are not using a removable device to update them.
 
 =item B<-c>
 
-Clean /var/cache/urpmi/headers directory on exit. 
+Clean F</var/cache/urpmi/headers> directory on exit.
 
 =item B<-f>
 
-Force rebuild of base files, or of hdlist files when specified twice. 
+Force rebuild of base files, or of hdlist files when specified twice.
 
 =item B<-q>
 
@@ -92,4 +91,4 @@ urpmi(8), urpmi.addmedia(8), urpmi.removemedia(8).
 =head1 AUTHOR
 
 Pascal Rigaux (original author), FranE<ccedil>ois Pons,
-Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer) 
+Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer)