From 292f247557450e9f515b408124361a64ec27aa79 Mon Sep 17 00:00:00 2001 From: Rafael Garcia-Suarez Date: Wed, 11 Jan 2006 09:41:44 +0000 Subject: Documentation nits: wording and presentation. --- pod/urpmi.8.pod | 37 ++++++++++++++++++------------------- pod/urpmi.addmedia.8.pod | 14 +++++++------- pod/urpmi.files.5.pod | 2 +- pod/urpmi.removemedia.8.pod | 4 ++-- pod/urpmq.8.pod | 14 ++++++-------- 5 files changed, 34 insertions(+), 37 deletions(-) diff --git a/pod/urpmi.8.pod b/pod/urpmi.8.pod index 7d761965..b696268c 100644 --- a/pod/urpmi.8.pod +++ b/pod/urpmi.8.pod @@ -84,16 +84,16 @@ of the urpmi database for searching packages and resolving dependencies. Install all required dependencies without asking. -=item B<--auto-update> +=item B<--auto-select> -Like B<--auto-select>, but also updates all relevant media before -selection of upgradeable packages is made. +Select all packages that can be upgraded, according to already installed +packages and packages listed in various registered media. -=item B<--auto-select> +=item B<--auto-update> -Automatically select all packages that have to be upgraded, according to -already installed packages and packages listed in various registered -media. +Like B<--auto-select>, but also updates all relevant media before +selection of upgradeable packages is made. This avoids a previous call to +C. =item B<--no-install> @@ -192,13 +192,13 @@ with the B<--root> option. =item B<--wget> -Use wget for downloading distant files. By default curl -is used if available, or wget instead. +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. +Use curl for downloading distant files. By default curl is used if +available, or wget instead. =item B<--curl-options> I<'options'> @@ -255,26 +255,26 @@ by default. =item B<--test> Test the installation of packages but do not actually install anything or -modify the system. (That's the same as B). +modify the system. (That's the same as C). =item B<--excludepath> I Do not install files of which the -names begin with the given I (same as B). +names begin with the given I (same as C). =item B<--excludedocs> -Do not install documents files (same as B). +Do not install documents files (same as C). =item B<--ignoresize> Don't check file systems for sufficient disk space before installation. -This is equivalent to B. +This is equivalent to C. =item B<--noscripts> Don't execute the scriptlets. -This is equivalent to B. +This is equivalent to C. =item B<--skip> I @@ -303,12 +303,11 @@ If multiple packages match the given substring, install them all. =item B<-p> -Allow search in provides to find package (default). +Allow search in provides to find the package (this is the default). =item B<-P> -Do not search in provides to find package (this -is the opposite of B<-p>). +Do not search in provides to find package (this is the opposite of B<-p>). =item B<-y> diff --git a/pod/urpmi.addmedia.8.pod b/pod/urpmi.addmedia.8.pod index 856fa820..45fc3d3d 100644 --- a/pod/urpmi.addmedia.8.pod +++ b/pod/urpmi.addmedia.8.pod @@ -65,7 +65,7 @@ is the location of the media directory on your machine (e.g. C). removable device is mounted. This works for removable drives, but also for ISO images mounted on a loop device. urpmi will then be able to re-mount the ISO image to the specified path (but the ISO image must be mounted -when you run B). +when you run C). =back @@ -105,13 +105,13 @@ Use specified HTTP proxy. =item B<--proxy-user> I Use specified user and password to use for proxy authentication. -Specifying B<--proxy-user=ask> will cause B to prompt for a +Specifying B<--proxy-user=ask> will cause C to prompt for a username and a password. =item B<--update> Add a medium which will be taken into -account by B or by B when looking for updates. +account by B or by C when looking for updates. =item B<--probe-synthesis> @@ -128,13 +128,13 @@ Do not try to find any synthesis or hdlist file. So, if you use a network media (http, ftp, etc.), specifying the location of a synthesis or hdlist with B is mandatory. -On the other hand, if you use a local media B will extract +On the other hand, if you use a local media C will extract all RPM headers and construct an hdlist by itself. =item B<--distrib> Retrieve a set of media from a distribution. Typically, the URL provided -to B will represent the parent directory of a directory +to C will represent the parent directory of a directory B, which in turn will contain various subdirectories for each medium of the distribution. > is combined with medium names found to create newer medium names in the urpmi database. The B @@ -158,7 +158,7 @@ of the distribution told by the installed mandriva-release package. Creates a virtual medium. This only works for C and C protocols, and no files will be created in F. The medium is always up-to-date and so it does not need -to be updated by B. +to be updated by C. =item B<--norebuild> @@ -169,7 +169,7 @@ if the original hdlist wasn't readable or was corrupted. Add the new media in the urpmi configuration file, but don't update it nor proceed to any -download. The media, to be usable, will need to be updated with B. +download. The media, to be usable, will need to be updated with C. =item B<--nopubkey> diff --git a/pod/urpmi.files.5.pod b/pod/urpmi.files.5.pod index 86827b3b..af1ad7d5 100644 --- a/pod/urpmi.files.5.pod +++ b/pod/urpmi.files.5.pod @@ -22,7 +22,7 @@ packages. That's why it's not world-readable. =item I<< /var/lib/urpmi/hdlist..cz >> Contains information about all known packages; it's a summary of rpm -headers. If an hdlist file is used for a medium, B can operate +headers. If an hdlist file is used for a medium, C can operate completely without accessing this medium (this is almost always the case). =item I<< /var/lib/urpmi/synthesis.hdlist..cz >> diff --git a/pod/urpmi.removemedia.8.pod b/pod/urpmi.removemedia.8.pod index 8d44cfb2..e01ed424 100644 --- a/pod/urpmi.removemedia.8.pod +++ b/pod/urpmi.removemedia.8.pod @@ -8,9 +8,9 @@ urpmi.removemedia - remove a rpm media from the known media of urpmi =head1 DESCRIPTION -B removes from all configuration files all references +urpmi.removemedia removes from all configuration files all references to the named media and to rpms from that media. > is a list of -names you first told to B. +names you first told to urpmi.addmedia. =head1 OPTIONS diff --git a/pod/urpmq.8.pod b/pod/urpmq.8.pod index 2ae909ab..ae7d8526 100644 --- a/pod/urpmq.8.pod +++ b/pod/urpmq.8.pod @@ -40,7 +40,7 @@ List available media and their URLs. =item B<--list-nodes> -List available nodes when using B<--parallel>. +List available nodes for parallel installation (when using B<--parallel>). =item B<--list-aliases> @@ -48,9 +48,8 @@ List available parallel aliases. =item B<--update> -Use only update -media. This means that urpmq will search and resolve dependencies only in -media marked as containing updates. +Use only update media. This means that urpmq will search and resolve +dependencies only in media marked as containing updates. =item B<--media> I @@ -78,9 +77,8 @@ searching packages and resolving dependencies. =item B<--auto-select> -Automatically select all packages that have to be -upgraded, according to already installed packages and packages listed in -various registered media. +Select all packages that can be upgraded, according to already installed +packages and packages listed in various registered media. =item B<--keep> @@ -158,7 +156,7 @@ and a password. =item B<--use-distrib> I -Configure urpmq on the fly from a distrib tree. You must be root to use +Configure urpmq on the fly from a distribution tree. You must be root to use this option. =item B<--env> I -- cgit v1.2.1