From e9fa375494fd1cfba1bfd7c040d614792079d831 Mon Sep 17 00:00:00 2001 From: Rafael Garcia-Suarez Date: Wed, 25 Jan 2006 16:15:16 +0000 Subject: More docs --- pod/urpmi.8.pod | 77 +++++++++++++++++++++++++++------------------------------ 1 file changed, 37 insertions(+), 40 deletions(-) (limited to 'pod') 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. To remove an existing medium, use -C. To update the package list (for example when the ftp -archive changes) use C. +the appropriate disk, if necessary. + +To add a new medium containing rpms, run C. To remove an +existing medium, use C. To update the package list (for +example when the ftp archive changes) use C. =head1 OPTIONS @@ -49,12 +56,12 @@ archive changes) use C. =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 @@ -72,8 +79,7 @@ B<--auto-select>. =item B<--sortmedia> I -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 @@ -97,8 +103,8 @@ C. =item B<--no-install> -Only download packages, don't install them. You'll find them in -F. +Only download packages, don't install them. After operation, you'll find +them in F. =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> +=item B<--split-level> I -Split urpmi's operation in small transactions when -the total number of packages to upgrade is greater than the given I. -This option is activated by default, and the default value of I is -20. +Split urpmi's operation in small transactions when the total number of +packages to upgrade is greater than the given I. This option is +activated by default, and the default value of I is 20. -=item B<--split-length I> +=item B<--split-length> I Split urpmi's operation in small transactions of at least I 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 defines which extension module is to be used by -urpmi (currently, urpmi-parallel-ka-run or urpmi-parallel-ssh are +urpmi (currently, C or C are available) and which machines should be updated. This alias is defined in the file F 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> +=item B<--limit-rate> I -Try to limit the download speed, I is given in bytes/sec. This +Try to limit the download speed. I 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), FranEois Pons, Rafael Garcia-Suarez, (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), -- cgit v1.2.1