yum-software-management yum-software-management-en.xml,1.21,1.22
Paul W. Frields (pfrields)
fedora-docs-commits at redhat.com
Sat Jul 23 20:47:25 UTC 2005
Author: pfrields
Update of /cvs/docs/yum-software-management
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv24534
Modified Files:
yum-software-management-en.xml
Log Message:
More editing for style and clarity
Index: yum-software-management-en.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- yum-software-management-en.xml 23 Jul 2005 00:18:43 -0000 1.21
+++ yum-software-management-en.xml 23 Jul 2005 20:47:23 -0000 1.22
@@ -402,8 +402,8 @@
Use only the name of the package with <command>yum</command>,
except when the exact version or type is necessary. <remark
role="fixme">When exactly is that required? I fixed the
- sentence structure but the meaning is obscure here.
- [PWF]</remark> For example, use
+ sentence structure but the meaning is obscure here. Tell the
+ reader the full story here. [PWF]</remark> For example, use
<filename>name-version</filename> to specify the exact version
of the application. The package listings provided by
<command>yum</command> use the format
@@ -455,42 +455,46 @@
<para>
On your desktop is an <application>Alert Icon</application> that
keeps you informed about package updates. Until your system is
- updated this appears as a red circle with a flashing exclamation
- mark. The alert icon is integrated with
- <application>up2date</application>, which enables you to easily
- install updates for your system.
+ updated the icon appears as a red circle with a flashing
+ exclamation mark. The Alert Icon is part of the
+ <application>up2date</application> application, which enables you
+ to easily install system updates.
</para>
<para>
- Also included in &FC; is
- <application>system-config-packages</application>. From the main
- menu, this is <menuchoice><guimenu>System
- Settings</guimenu><guimenuitem>Add/Remove
- Applications</guimenuitem></menuchoice>. Unlike
- <application>up2date</application> and <command>yum</command>, it
- installs software packages from your &FC; installation discs, and
- does not use repositories. This application is used on systems
- that do not have a network connection.
+ &FC; also includes
+ <application>system-config-packages</application>. To run this
+ application from the graphical interface, select
+ <menuchoice>
+ <guimenu>Desktop</guimenu>
+ <guisubmenu>System Settings</guisubmenu>
+ <guimenuitem>Add/Remove Applications</guimenuitem>
+ </menuchoice>. Unlike <application>up2date</application> and
+ <command>yum</command>,
+ <application>system-config-packages</application> installs
+ software packages from your &FC; installation discs only, and does
+ not use repositories. This application is used on systems that do
+ not have a network connection.
</para>
<para>
The <command>rpm</command> command-line utility has many functions
- for working with individual RPM packages. It may also be used to
- manually install and remove packages from your system. Installing
- software with the <command>rpm</command> utility requires you to
- manually check and install the dependencies of the software. For
- this reason, using the <command>rpm</command> utility to manage
- software is not recommended.
+ for working with individual RPM packages. You may use it to
+ manually install and remove packages from your system. If you
+ install software with the <command>rpm</command> utility, you must
+ manually check and install any dependencies. For this reason,
+ <command>yum</command> is the recommended method for installing
+ software.
</para>
<caution>
<title>Current Package Versions</title>
<para>
- Using <application>up2date</application> and
- <command>yum</command> ensures that you have the most recent
- version of the packages that are being installed. Other methods
- do not guarantee that the packages are current.
+ The <application>up2date</application> and
+ <command>yum</command> utilities ensure that you have the most
+ recent version of software packages. Other methods do not
+ guarantee that the packages are current.
</para>
</caution>
</section>
@@ -498,7 +502,8 @@
<section id="sn-managing-packages">
<title>Managing Software with <command>yum</command></title>
<indexterm>
- <primary>yum, package management</primary>
+ <primary>yum</primary>
+ <secondary>software management</secondary>
</indexterm>
<para>
The <command>yum</command> utility may modify the software on your
@@ -509,68 +514,64 @@
<itemizedlist>
<listitem>
<para>
- By installing new software from repositories or a package
+ It may install new software from repositories or a package
file.
</para>
</listitem>
<listitem>
<para>
- By updating existing software on your system.
+ It may update existing software on your system.
</para>
</listitem>
<listitem>
<para>
- By removing unwanted software from your system.
+ It may remove unwanted software from your system.
</para>
</listitem>
</itemizedlist>
</para>
<para>
- In each case you must specify the function and the criteria, such
- as the name of the package or package group. Simple examples are
- given in each section.
+ To use <command>yum</command>, specify a function and one or more
+ packages or package groups. Each section below gives some
+ examples.
</para>
<tip>
<title>Package Names</title>
<para>
- You may use any of the following formats for specifying a
- package in a <command>yum</command> operation:
- <filename>name</filename>,
- <filename>name.architecture</filename>,
- <filename>name-version</filename>,
- <filename>name-version-release</filename>,
- <filename>name-version-release.architecture</filename>, and
- <filename>epoch:name-version-release.architecture</filename>.
+ You may use any of the following formats to specify a package in
+ a <command>yum</command> operation: <replaceable>name</replaceable>,
+ <replaceable>name.architecture</replaceable>,
+ <replaceable>name-version</replaceable>,
+ <replaceable>name-version-release</replaceable>,
+ <replaceable>name-version-release.architecture</replaceable>, and
+ <replaceable>epoch:name-version-release.architecture</replaceable>.
</para>
</tip>
<para>
To use the repositories <command>yum</command> downloads data
- files from each of the repositories that it is configured to use.
- On a slow connection downloading the repository index files and
- the <firstterm>header</firstterm> file for each package may take
- several seconds to complete.
+ files from each of the configured repositories. On a slow
+ connection, it may take several seconds to download the required
+ files for each package.
</para>
<para>
- When installing, updating or removing software,
- <command>yum</command> first determines the best set of actions to
- produce the required result, and displays the transaction for you
- to approve. This may include installing, updating or removing
- other packages in addition to the package that you specified, in
- order to resolve the dependencies of the software.
- </para>
-
- <para>
- As an example, this is the transaction for installing
- <filename>tsclient</filename>:
+ During operation, <command>yum</command> first determines the best
+ set of actions to produce the required result, and displays the
+ transaction for you to approve. The <command>yum</command> utility
+ may prompt you to approve installation, update, or removal of
+ additional packages in addition to the package that you specified.
+ These actions may be necessary to resolve software dependencies.
</para>
<example id="yum-transaction-format">
<title>Format of <command>yum</command> Transaction Reports</title>
-<programlisting>
- <![CDATA[
-=============================================================================
+ <para>
+ This is an example of the transaction for installing
+ <filename>tsclient</filename>:
+ </para>
+<screen>
+<computeroutput>=============================================================================
Package Arch Version Repository Size
=============================================================================
Installing:
@@ -584,16 +585,15 @@
Update 0 Package(s)
Remove 0 Package(s)
Total download size: 355 k
-Is this ok [y/N]:
- ]]>
- </programlisting>
+Is this ok [y/N]:</computeroutput>
+</screen>
</example>
<para>
- Review the list of changes before pressing
- <userinput>y</userinput> to accept and begin the process. No
- packages are downloaded or changed if you press
- <userinput>N</userinput>.
+ 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>
More information about the docs-commits
mailing list