More docs

1 files changed, 37 insertions, 40 deletions

diff --git a/pod/urpmi.8.pod b/pod/urpmi.8.pod
index f4786699..e7316889 100644
--- a/pod/urpmi.8.pod
+++ b/pod/urpmi.8.pod
@@ -8,13 +8,15 @@ urpmi - rpm downloader, installer and dependency solver
 
 =head1 DESCRIPTION
 
-The purpose of urpmi is to install rpms (or rpm files), including all
-their dependencies. You can also use it to install the build dependencies
-of a source package (or of an rpm spec file), or a source package itself.
+The purpose of urpmi is to install rpm packages, including all their
+dependencies. You can also use it to install the build dependencies of an
+srpm (an rpm source package), or the build dependencies read from a plain
+rpm spec file; or to install a source package itself in order to rebuild
+it afterwards.
 
 You can compare rpm vs. urpmi with insmod vs. modprobe or dpkg vs apt-get.
-Just launch urpmi followed by what you think is the name of the
-package(s), and urpmi will:
+Just run urpmi followed by what you think is the name of the package(s),
+and urpmi will:
 
 =over 4
 
@@ -32,16 +34,21 @@ dependencies are already installed.
 If not, propose to install the dependencies, and on a positive answer,
 proceed.
 
+=item *
+
+Finish by installing the requested package(s).
+
 =back
 
 Note that urpmi handles installations from various types of media (ftp,
-http, rsync, local and nfs volumes, and removable media such as CDROMs)
-and is able to install dependencies from a medium different from the
+http, rsync, local and nfs volumes, and removable media such as CDROMs or
+DVDs) and is able to install dependencies from a medium different from the
 original package's media. For removable media, urpmi may ask you to insert
-the appropriate disk, if necessary. To add a new medium containing rpms,
-run C<urpmi.addmedia>. To remove an existing medium, use
-C<urpmi.removemedia>. To update the package list (for example when the ftp
-archive changes) use C<urpmi.update>.
+the appropriate disk, if necessary.
+
+To add a new medium containing rpms, run C<urpmi.addmedia>. To remove an
+existing medium, use C<urpmi.removemedia>. To update the package list (for
+example when the ftp archive changes) use C<urpmi.update>.
 
 =head1 OPTIONS
 
@@ -49,12 +56,12 @@ archive changes) use C<urpmi.update>.
 
 =item B<--help>
 
-Print 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<--update>
 
-Use only update media. This means that urpmi will search
-packages and resolve dependencies only in media marked as containing updates.
+Use only update media. This means that urpmi will search packages and
+resolve dependencies only in media marked as containing updates.
 
 =item B<--media> I<media1,...,mediaN>
 
@@ -72,8 +79,7 @@ B<--auto-select>.
 
 =item B<--sortmedia> I<media1,...,mediaN>
 
-Sort the specified media. Substrings may be used
-to simplify grouping.
+Sort the specified media. Substrings may be used to simplify grouping.
 
 =item B<--synthesis> I<file>
 
@@ -97,8 +103,8 @@ C<urpmi.update>.
 
 =item B<--no-install>
 
-Only download packages, don't install them. You'll find them in
-F</var/cache/urpmi/rpms>.
+Only download packages, don't install them. After operation, you'll find
+them in F</var/cache/urpmi/rpms>.
 
 =item B<--no-uninstall>
 
@@ -107,20 +113,18 @@ This can be safer in auto mode.
 
 =item B<--keep>
 
-When some dependencies cannot be satisfied,
-change the selection of packages to try to keep existing packages instead
-of removing them. This behaviour generally rejects the upgrade of packages
-given on command line (or when using B<--auto-select>) when a dependency error
-occurs.
+When some dependencies cannot be satisfied, change the selection of
+packages to try to keep existing packages instead of removing them. This
+behaviour generally rejects the upgrade of packages given on command line
+(or when using B<--auto-select>) when a dependency error occurs.
 
-=item B<--split-level I<number>>
+=item B<--split-level> I<number>
 
-Split urpmi's operation in small transactions when
-the total number of packages to upgrade is greater than the given I<number>.
-This option is activated by default, and the default value of I<number> is
-20.
+Split urpmi's operation in small transactions when the total number of
+packages to upgrade is greater than the given I<number>. This option is
+activated by default, and the default value of I<number> is 20.
 
-=item B<--split-length I<count>>
+=item B<--split-length> I<count>
 
 Split urpmi's operation in small transactions of at
 least I<count> packages. The default is 1 and setting this value to 0 just
@@ -176,7 +180,7 @@ this case.
 Activate distributed execution of urpmi to other machines (it is mandatory
 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, urpmi-parallel-ka-run or urpmi-parallel-ssh are
+urpmi (currently, C<urpmi-parallel-ka-run> or C<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.
 
@@ -212,9 +216,9 @@ Specify additional command-line options to be passed to curl, rsync or
 wget when retrieving files. If several options are to be passed, separate
 them with spaces and enclose them in quotes.
 
-=item B<--limit-rate I<rate>>
+=item B<--limit-rate> I<rate>
 
-Try to limit the download speed, I<rate> is given in bytes/sec. This
+Try to limit the download speed. I<rate> is given in bytes/sec. This
 option is not active by default.
 
 =item B<--resume>
@@ -437,16 +441,9 @@ with an older version.
 
 =head1 AUTHOR
 
-Pascal Rigaux (original author), Francois Pons,
+Pascal Rigaux (original author), FranE<ccedil>ois Pons,
 Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer)
 
-=head1 CONTRIBUTORS
-
-Please mail to authors if you are not belonging to this alphabetically
-sorted list after having contributed. Andrej Borsenkow, Guillaume
-Cottenceau, Philippe Libat, Bryan Paxton, Guillaume Rousse, Michael
-Scherer, Alexander Skwar, Olivier Thauvin, Erwan Velu, Florent Villard.
-
 =head1 SEE ALSO
 
 urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),