yum-software-management/en_US yum-software-management.xml,1.6,1.7
Karsten Wade (kwade)
fedora-docs-commits at redhat.com
Mon Aug 6 04:39:29 UTC 2007
Author: kwade
Update of /cvs/docs/yum-software-management/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv9620/en_US
Modified Files:
yum-software-management.xml
Log Message:
alerted that link was outdated, but the entire concept is out; we don't support or maintain content about versions of Fedora that old, so I commented out the section; anyone who wants to maintain the legacy document can update it for their use.
Index: yum-software-management.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/en_US/yum-software-management.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- yum-software-management.xml 30 Apr 2006 14:47:52 -0000 1.6
+++ yum-software-management.xml 6 Aug 2007 04:39:27 -0000 1.7
@@ -1,19 +1,461 @@
-<!-- $Id: -->
-
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
-%FDP-ENTITIES;
-<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
-%DOC-ENTITIES;
+<!-- Group: Automatic Entities -->
+
+ <!-- Local entities for Yum Tutorial -->
+
+ <!-- Group: Document revision markings -->
+
+ <!ENTITY DOCNAME "yum-software-management" > <!-- Document name -->
+ <!ENTITY DOCVERSION "1.31" > <!-- Version number -->
+ <!ENTITY DOCDATE "2006-04-30" > <!-- Date of last revision -->
+ <!ENTITY DOCID "&DOCNAME;-&DOCVERSION; (&DOCDATE;)" > <!-- Document ID -->
+
+ <!-- Group: Miscellaneous -->
+
+ <!ENTITY FCLOCALVER "5" > <!-- Local version of Fedora Core for this document -->
+<!--
+ These common entities are useful shorthand
+ terms and names, which may be subject to
+ change at anytime. This is an important
+ value the entity provides, a single location
+ to update terms and common names.
+-->
+
+<!-- *************** Fedora common entities *************** -->
+<!ENTITY FED "Fedora"> <!-- Generic root term -->
+<!ENTITY CORE "Core"> <!-- Generic root term -->
+<!ENTITY FC "&FED; &CORE;"> <!-- Generic main project name -->
+<!ENTITY DISTRO "&FC;"> <!-- Legacy entity -->
+<!ENTITY FCX "FC"> <!-- Short project name -->
+<!ENTITY FP "&FED; Project"> <!-- Generic overall project name -->
+<!ENTITY FDP "&FED; Documentation Project"> <!-- Generic docs project name -->
+<!ENTITY FDPX "&FED; Docs Project"> <!-- Short docs project name -->
+<!ENTITY EX "Extras"> <!-- cf. Core -->
+<!ENTITY FEX "&FED; &EX;"> <!-- cf. Fedora Core -->
+
+<!ENTITY FP-URL "<ulink url='http://www.fedoraproject.org/'/>"> <!-- Fedora Project URL -->
+<!ENTITY FDP-URL "<ulink url='http://www.fedoraproject.org/wiki/DocsProject/'/>"> <!-- Fedora Docs Project URL -->
+<!ENTITY FDPDOCS-URL "<ulink url='http://docs.fedoraproject.org/'/>"> <!-- Fedora Documentation (repository) URL -->
+
+<!ENTITY BZ "Bugzilla"> <!-- Bugzilla -->
+<!ENTITY BZ-URL "<ulink url='http://bugzilla.redhat.com/'>http://bugzilla.redhat.com/</ulink>"> <!-- Bugzilla URL -->
+<!ENTITY BZ-PROD "&FED; Documentation"> <!-- Bugzilla product for Fedora docs -->
+
+<!-- *************** Fedora version numbers *************** -->
+<!ENTITY FCVER "6"> <!-- Current release version of main project -->
+<!ENTITY TESTVER "test3"> <!-- Current test number of main project -->
+<!ENTITY FCTESTVER "6 &TESTVER;"> <!-- Current test version of main project -->
+
+
+<!-- ************** other common names *********** -->
+<!ENTITY RH "Red Hat"> <!-- The generic term "Red Hat" -->
+<!ENTITY FORMAL-RHI "&RH;, Inc."> <!-- The generic term "Red Hat, Inc. -->
+<!ENTITY RHL "&RH; Linux"> <!-- The generic term "Red Hat Linux" -->
+<!ENTITY RHN "&RH; Network"> <!-- The generic term "Red Hat Network" -->
+<!ENTITY RHEL "&RH; Enterprise Linux"> <!-- The generic term "Red Hat Enterprise Linux" -->
+
+<!-- ************** technology terms *********** -->
+<!ENTITY SEL "SELinux"> <!-- Generic technology term -->
+
+<!-- ************** common doc files *********** -->
+<!ENTITY LEGALNOTICE SYSTEM "./legalnotice-en_US.xml">
+<!ENTITY LEGALNOTICE-CONTENT SYSTEM "./legalnotice-content-en_US.xml">
+<!ENTITY LEGALNOTICE-OPL SYSTEM "./legalnotice-opl-en_US.xml">
+<!ENTITY LEGALNOTICE-OPL-CONTENT SYSTEM "./opl.xml">
+<!ENTITY LEGALNOTICE-RELNOTES SYSTEM "./legalnotice-relnotes-en_US.xml">
+<!ENTITY LEGALNOTICE-SECTION SYSTEM "./legalnotice-section-en_US.xml">
+<!ENTITY BUG-REPORTING SYSTEM "./bugreporting-en_US.xml">
+
+<!-- ************** common applications? *********** -->
+
+<!-- ************** required by build scripts *********** -->
+
+<!ENTITY PROJECT "&FP;">
+
+<!-- ************** tutorial titles ********** -->
+
+<!ENTITY IG "Installation Guide">
+<!ENTITY DOCG "Documentation Guide">
+
+<!-- ************** tutorial URLs *********** -->
+
+<!ENTITY IG-URL "<ulink url='http://docs.fedoraproject.org/install-guide/'/>">
+<!ENTITY DOCG-URL "<ulink url='http://docs.fedoraproject.org/documentation-guide/'/>">
+
+<!-- ************** status notices ************* -->
+<!ENTITY DRAFTNOTICE SYSTEM "./draftnotice-en_US.xml">
+<!ENTITY LEGACYNOTICE SYSTEM "./legacynotice-en_US.xml">
+<!ENTITY OBSOLETENOTICE SYSTEM "./obsoletenotice-en_US.xml">
+<!ENTITY DEPRECATEDNOTICE SYSTEM "./deprecatednotice-en_US.xml">
]>
<article id="yum-software-management" lang="en_US">
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
- href="fdp-info.xml"/>
-
+<articleinfo>
+ <title>Managing Software with yum</title>
+ <copyright>
+ <year>2006</year>
+ <holder>Stuart Ellis</holder>
+ </copyright>
+ <authorgroup>
+ <author>
+ <surname>Ellis</surname>
+ <firstname>Stuart</firstname>
+ </author>
+ <editor>
+ <surname>Frields</surname>
+ <firstname>Paul</firstname>
+ <othername>W.</othername>
+ </editor>
+ </authorgroup>
+ <revhistory>
+ <revision>
+ <revnumber>1.31</revnumber>
+ <date>2006-04-30</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Amended search section.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.3</revnumber>
+ <date>2006-03-24</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Minor restructuring of sections.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.2</revnumber>
+ <date>2006-03-19</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Added sections on caching and plugins.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.1</revnumber>
+ <date>2006-03-13</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Updated for Fedora 5.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0.5</revnumber>
+ <date>2005-11-28</date>
+ <authorinitials>PaulFrields</authorinitials>
+ <revdescription>
+ <para>
+ Fixed some uses of "Fedora" to read "Fedora Core" where
+ appropriate.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0.4</revnumber>
+ <date>2005-11-15</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Updated section on proxy servers. Fixed #166122.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0.3</revnumber>
+ <date>2005-10-13</date>
+ <authorinitials>PaulFrields</authorinitials>
+ <revdescription>
+ <para>
+ Fix wording (#170584).
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0.2</revnumber>
+ <date>2005-08-26</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Fix localinstall information.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0.1</revnumber>
+ <date>2005-08-18</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Added information on installing without repository and
+ manually adding keys.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0</revnumber>
+ <date>2005-08-13</date>
+ <authorinitials>PaulFrields</authorinitials>
+ <revdescription>
+ <para>
+ Publish to official project page.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>0.6</revnumber>
+ <date>2005-07-25</date>
+ <authorinitials>PaulFrields</authorinitials>
+ <revdescription>
+ <para>
+ Edited for style and usage; BETA publication.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>0.5</revnumber>
+ <date>2005-07-19</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Updated for Fedora Core 4.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>0.4</revnumber>
+ <date>2005-06-01</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Initial import into CVS.
+ </para>
+ </revdescription>
+ </revision>
+ </revhistory>
+ <legalnotice id="legalnotice-opl">
+ <para id="opl.permission">
+ Permission is granted to copy, distribute, and/or modify this
+ document under the terms of the Open Publication Licence,
+ Version 1.0, or any later version. The terms of the OPL are set
+ out below.
+ </para>
+ <orderedlist numeration="upperroman" id="opl.terms">
+ <listitem id="opl.require">
+ <bridgehead>REQUIREMENTS ON BOTH UNMODIFIED AND MODIFIED
+ VERSIONS</bridgehead>
+ <para>
+ Open Publication works may be reproduced and distributed in
+ whole or in part, in any medium physical or electronic,
+ provided that the terms of this license are adhered to, and
+ that this license or an incorporation of it by reference
+ (with any options elected by the author(s) and/or publisher)
+ is displayed in the reproduction.
+ </para>
+
+ <para>
+ Proper form for an incorporation by reference is as follows:
+ </para>
+
+ <para>
+ Copyright (c) <year> by <author's name or
+ designee>. This material may be distributed only subject
+ to the terms and conditions set forth in the Open
+ Publication License, vX.Y or later (the latest version is
+ presently available at <ulink
+ url="http://www.opencontent.org/openpub/"/>).
+ </para>
+
+ <para>
+ The reference must be immediately followed with any options
+ elected by the author(s) and/or publisher of the document
+ (see section VI). Commercial redistribution of Open
+ Publication-licensed material is permitted. Any publication
+ in standard (paper) book form shall require the citation of
+ the original publisher and author. The publisher and
+ author's names shall appear on all outer surfaces of the
+ book. On all outer surfaces of the book the original
+ publisher's name shall be as large as the title of the work
+ and cited as possessive with respect to the title.
+ </para>
+ </listitem>
+ <listitem id="opl.copyright">
+ <bridgehead>COPYRIGHT</bridgehead>
+ <para>
+ The copyright to each Open Publication is owned by its
+ author(s) or designee.
+ </para>
+ </listitem>
+ <listitem id="opl.scope">
+ <bridgehead>SCOPE OF LICENSE</bridgehead>
+
+ <para>
+ The following license terms apply to all Open Publication
+ works, unless otherwise explicitly stated in the document.
+ </para>
+
+ <para>
+ Mere aggregation of Open Publication works or a portion of
+ an Open Publication work with other works or programs on the
+ same media shall not cause this license to apply to those
+ other works. The aggregate work shall contain a notice
+ specifying the inclusion of the Open Publication material
+ and appropriate copyright notice.
+ </para>
+
+ <para>
+ SEVERABILITY. If any part of this license is found to be
+ unenforceable in any jurisdiction, the remaining portions of
+ the license remain in force.
+ </para>
+
+ <para>
+ NO WARRANTY. Open Publication works are licensed and
+ provided "as is" without warranty of any kind, express or
+ implied, including, but not limited to, the implied
+ warranties of merchantability and fitness for a particular
+ purpose or a warranty of non-infringement.
+ </para>
+ </listitem>
+ <listitem id="opl.modified.works">
+ <bridgehead>REQUIREMENTS ON MODIFIED WORKS</bridgehead>
+
+ <para>
+ All modified versions of documents covered by this license,
+ including translations, anthologies, compilations and
+ partial documents, must meet the following requirements:
+ </para>
+
+ <orderedlist>
+ <listitem>
+ <para>
+ The modified version must be labeled as such.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The person making the modifications must be identified
+ and the modifications dated.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Acknowledgement of the original author and publisher if
+ applicable must be retained according to normal academic
+ citation practices.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The location of the original unmodified document must be
+ identified.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The original author's (or authors') name(s) may not be
+ used to assert or imply endorsement of the resulting
+ document without the original author's (or authors')
+ permission.
+ </para>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ <listitem id="opl.good-practice">
+ <bridgehead>GOOD-PRACTICE RECOMMENDATIONS</bridgehead>
+
+ <para>
+ In addition to the requirements of this license, it is
+ requested from and strongly recommended of redistributors
+ that:
+ </para>
+
+ <orderedlist>
+ <listitem>
+ <para>
+ If you are distributing Open Publication works on
+ hardcopy or CD-ROM, you provide email notification to
+ the authors of your intent to redistribute at least
+ thirty days before your manuscript or media freeze, to
+ give the authors time to provide updated documents. This
+ notification should describe modifications, if any, made
+ to the document.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ All substantive modifications (including deletions) be
+ either clearly marked up in the document or else
+ described in an attachment to the document.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Finally, while it is not mandatory under this license,
+ it is considered good form to offer a free copy of any
+ hardcopy and CD-ROM expression of an Open
+ Publication-licensed work to its author(s).
+ </para>
+ </listitem>
+ </orderedlist>
+
+ </listitem>
+ <listitem id="opl.options">
+ <bridgehead>LICENSE OPTIONS</bridgehead>
+
+ <para>
+ The author(s) and/or publisher of an Open
+ Publication-licensed document may elect certain options by
+ appending language to the reference to or copy of the
+ license. These options are considered part of the license
+ instance and must be included with the license (or its
+ incorporation by reference) in derived works.
+ </para>
+
+ <para>
+ A. To prohibit distribution of substantively modified
+ versions without the explicit permission of the author(s).
+ "Substantive modification" is defined as a change to the
+ semantic content of the document, and excludes mere changes
+ in format or typographical corrections.
+ </para>
+
+ <para>
+ To accomplish this, add the phrase 'Distribution of
+ substantively modified versions of this document is
+ prohibited without the explicit permission of the copyright
+ holder.' to the license reference or copy.
+ </para>
+
+ <para>
+ B. To prohibit any publication of this work or derivative
+ works in whole or in part in standard (paper) book form for
+ commercial purposes is prohibited unless prior permission is
+ obtained from the copyright holder.
+ </para>
+
+ <para>
+ To accomplish this, add the phrase 'Distribution of the work
+ or derivative of the work in any standard (paper) book form
+ is prohibited unless prior permission is obtained from the
+ copyright holder.' to the license reference or copy.
+ </para>
+ </listitem>
+ </orderedlist>
+ </legalnotice>
+ </articleinfo>
+
<section id="sn-introduction">
<title>Introduction</title>
@@ -1170,7 +1612,7 @@
include &FEX;, the default source of packages for software that is
not included with &FC;.
</para>
-
+<!-- No longer support content about these versions of Fedora Core ...
<note>
<title>&FEX; Repositories for Previous Versions of &FC;</title>
@@ -1184,7 +1626,7 @@
url="http://www.fedora.us/"/>.
</para>
</note>
-
+-->
<para>
If the &FP; does not supply packages for a product, the
manufacturer may provide or recommend a separate repository.
@@ -1382,87 +1824,6 @@
</para>
</step>
</procedure>
-<!-- What with the "web of trust," removing GPG keys is not really -->
-<!-- something we should encourage. Having an extra GPG key in the RPM -->
-<!-- database is not a vulnerability, nor does it hamper the system in -->
-<!-- any way. These are probably a couple of reasons Seth didn't build -->
-<!-- this function into yum as part of "clean all," for example. Since -->
-<!-- we just had several admonitions against people running the rpm -->
-<!-- command on its own anyway, I would just omit this part -->
-<!-- completely. [PWF] -->
-<!--
-
- <important>
- <title>Remove Unneeded Public Keys</title>
-
- <para>
- If you will not be using any further packages from a provider,
- remove their public key from the <command>rpm</command>
- keyring using the procedure described in
- <xref linkend="sn-removing-publickeys" />.
- </para>
- </important>
- </section>
-
- <section id="sn-removing-publickeys">
- <title>Removing Public Keys</title>
- <indexterm>
- <primary>public keys, removing</primary>
- </indexterm>
- <para>
- To remove a public key from the keyring you first must determine
- the full name of the key, as it registered in
- <command>rpm</command>. Run this command to view the details of
- the public keys on the <command>rpm</command> keyring:
- </para>
-<screen>
-<userinput>rpm -qi gpg-pubkey-*</userinput>
-</screen>
- <para>
- Locate the heading for the relevant public key. The public key
- headings follow this format:
- </para>
-
- <example id="publickey-header-format">
- <title>Format of <command>rpm</command> Public Key Headers</title>
-<screen>
-<computeroutput>Name : gpg-pubkey Relocations: (not relocatable)
-Version : 4f2a6fd2 Vendor: (none)
-Release : 3f9d9d3b Build Date: Wed 15 Jun 2005 09:55:33 PM BST
-Install Date: Wed 15 Jun 2005 09:55:33 PM BST Build Host: localhost
-Group : Public Keys Source RPM: (none)
-Size : 0 License: pubkey
-Signature : (none)
-Summary : gpg(Fedora Project <fedora at redhat.com>)
-Description :</computeroutput>
-</screen>
- </example>
-
- <para>
- Add the <option>Version</option> and <option>Release</option>
- attributes to <option>gpg-pubkey-</option> to make the complete
- name of the key, in the form
- <option>gpg-pubkey-Version_number-Release_number</option>. The
- <command>rpm</command> identification for the &FP; public key
- shown above is: <option>gpg-pubkey-4f2a6fd2-3f9d9d3b</option>.
- </para>
-
- <para>
- Once you know the identification name of the key, use the
- command <command>rpm <option>-e</option></command> to remove it.
- To remove the &FP; public key shown above the exact command
- would be:
- </para>
-<screen>
-<userinput>su -c 'rpm -e <replaceable>gpg-pubkey-4f2a6fd2-3f9d9d3b</replaceable>'</userinput>
-</screen>
- <para>
- Enter the password for the
- <systemitem class="username">root</systemitem> account when
- prompted.
- </para>
-
--->
</section>
</section>
@@ -2081,10 +2442,3 @@
<index id="generated-index"></index>
</article>
-
-<!--
-Local variables:
-mode: xml
-fill-column: 72
-End:
--->
More information about the Fedora-docs-commits
mailing list