5:52 p.m.
Author: elliss
Update of /cvs/docs/yum-software-management
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27815
Modified Files:
yum-software-management-en.xml
Log Message:
- Added note about installing without repository to the "Managing" section, so
that the section reads better on the Website.
- Amended section on manually adding keys, as yum 2.1.1 does actually support gpgcheck (if
you have a definition file that actually uses the option).
- Tidied up wording of "Repository Compatibility" on alternatives to Fedora
packages.
Index: yum-software-management-en.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -r1.42 -r1.43
--- yum-software-management-en.xml 17 Aug 2005 17:02:18 -0000 1.42
+++ yum-software-management-en.xml 18 Aug 2005 22:52:52 -0000 1.43
@@ -4,7 +4,7 @@
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM
"../docs-common/common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
-<!ENTITY BOOKID "yum-software-management-1.0 (2005-08-13)"> <!--
change version of manual and date here -->
+<!ENTITY BOOKID "yum-software-management-1.0.1 (2005-08-18)"> <!--
change version of manual and date here -->
<!-- Bugzilla bug number for the draft notice -->
<!ENTITY BUG-NUM "155190">
@@ -113,7 +113,7 @@
<para>
This document describes the configuration of
<command>yum</command> on &FED; &FCLOCALVER; systems. You
must
- perform the additional step described in
+ perform the additional step noted in
<xref linkend="sn-authorizing-package-sources" /> to enable
<command>yum</command> on &FED; 3.
</para>
@@ -618,14 +618,19 @@
</indexterm>
<para>
Use the <command>yum</command> utility to modify the software on
- your system in three ways:
+ your system in four ways:
</para>
<para>
<itemizedlist>
<listitem>
<para>
- To install new software from repositories or a package file
+ To install new software from package repositories
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ To install new software from an individual package file
</para>
</listitem>
<listitem>
@@ -640,6 +645,18 @@
</listitem>
</itemizedlist>
</para>
+<!-- SE: This duplicates text from the admonition in sn-about-repositories. It's
here as well because the Fedora site has a link straight to this section -->
+ <important>
+ <title>Installing Software from a Package File</title>
+
+ <para>
+ The <command>yum</command> commands shown in this section use
+ repositories as package sources. Refer to
+ <xref linkend="sn-yum-installing-frompackage"/> for details of
+ using <command>yum</command> to install software from an
+ individual package file.
+ </para>
+ </important>
<para>
To use <command>yum</command>, specify a function and one or more
@@ -690,13 +707,10 @@
</example>
<para>
- Review the list of changes, and then press
- <keycap>y</keycap>
- to accept and begin the process. If you press
- <keycap>N</keycap>
- or
- <keycap>Enter</keycap>
- , <command>yum</command> does not download or change any packages.
+ Review the list of changes, and then press <keycap>y</keycap> to
+ accept and begin the process. If you press <keycap>N</keycap> or
+ <keycap>Enter</keycap> , <command>yum</command> does not
download
+ or change any packages.
</para>
<note>
@@ -710,9 +724,9 @@
</note>
<para>
- The <command>yum</command> utility imports the repository public
- key if it is not already installed on the <command>rpm</command>
- keyring.
+ The <command>yum</command> utility also imports the repository
+ public key if it is not already installed on the
+ <command>rpm</command> keyring.
</para>
<example id="yum-publickey-import">
@@ -731,13 +745,18 @@
</example>
<para>
- Check the public key, and then press
- <keycap>y</keycap>
- to import the key and authorize the key for use. If you press
- <keycap>N</keycap>
- or
- <keycap>Enter</keycap>
- , <command>yum</command> stops without installing any packages.
+ Check the public key, and then press <keycap>y</keycap> to import
+ the key and authorize the key for use. If you press
+ <keycap>N</keycap> or <keycap>Enter</keycap> ,
+ <command>yum</command> stops without installing any packages.
+ </para>
+
+ <para>
+ To ensure that downloaded packages are genuine,
+ <command>yum</command> verifies the digital signature of each
+ package against the public key of the provider. Once all of the
+ packages required for the transaction are successfully downloaded
+ and verified, <command>yum</command> applies them to your system.
</para>
<tip>
<title>Downloads are Cached</title>
@@ -1268,19 +1287,15 @@
class="username">root</systemitem> password.
</para>
- <para>
- You must manually import all public keys on &FED; 3 and earlier
- systems. This includes the &FED; public key. To import the &FED;
- public key on &FED; 3, type this command:
- </para>
-<screen>
-<userinput>su -c 'rpm --import
/usr/share/rhn/RPM-GPG-KEY-fedora'</userinput>
-</screen>
- <para>
- At the prompt, enter the
- <systemitem
- class="username">root</systemitem> password.
- </para>
+ <important>
+ <title>Importing the &FED; Key on &FED; 3</title>
+
+ <para>
+ To add the &FED; public key to the <command>rpm</command>
+ keyring on &FED; 3 systems, run the command <command>su -c
+ 'rpm --import /usr/share/rhn/RPM-GPG-KEY-fedora'</command>.
+ </para>
+ </important>
</section>
<section id="sn-compat-repositories">
@@ -1304,18 +1319,24 @@
Always read the web site of the repository for information on
package compatibility before you add it as a package source.
Separate repository providers may offer different and
- incompatible versions of the same software. In some cases,
- third-party repositories may also include alternative packages
- for software provided by &FP; repositories that are not
- compatible with other &FED; packages.
+ incompatible versions of the same software. Third-party
+ repositories may also provide alternative packages for software
+ that is included in &FED; repositories.
+ </para>
+
+ <para>
+ Alternative packages may contain versions of the software that
+ function differently from the version in the &FP; packages.
+ Determine the benefits and potential incompatibilities before
+ replacing &FP; packages with alternative versions.
</para>
<caution>
<title>Incompatible Repositories</title>
<para>
- If you use incompatible repositories <command>yum</command>
- operations may fail.
+ If you configure your system to use incompatible repositories
+ <command>yum</command> operations may fail.
</para>
</caution>
@@ -1477,9 +1498,9 @@
</indexterm>
<para>
By default, <command>yum</command> retains the packages and
- package data files that it downloads, so they may be reused in
- future operations without being downloaded again. To purge the
- package data files, use this command:
+ package data files that it downloads, so that they may be reused
+ in future operations without being downloaded again. To purge
+ the package data files, use this command:
</para>
<screen>
<userinput>su -c 'yum clean headers'</userinput>