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>
docs-commits@lists.fedoraproject.org