yum-software-management yum-software-management-en.xml,1.18,1.19

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/yum-software-management
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv16729/yum-software-management

Modified Files:
	yum-software-management-en.xml 
Log Message:
Some style edits, still working on this...


Index: yum-software-management-en.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- yum-software-management-en.xml	20 Jul 2005 00:55:56 -0000	1.18
+++ yum-software-management-en.xml	21 Jul 2005 16:54:45 -0000	1.19
@@ -124,59 +124,73 @@
     <section id="sn-yum-additional-resources">
       <title>Additional Resources</title>
       <indexterm>
-        <primary>yum, documentation</primary>
+        <primary>yum</primary>
+        <secondary>documentation</secondary>
       </indexterm>
       <indexterm>
-        <primary>yum, man pages</primary>
+        <primary>yum</primary>
+        <secondary>man pages</secondary>
       </indexterm>
       <para>
-        The <command>yum</command> utility has features and options that
-        are not discussed in this document. Read the
-        <command>man</command> pages for <command>yum(8)</command> and
+        The <command>yum</command> utility has features and options not
+        discussed in this document. Read the <command>man</command>
+        pages for <command>yum(8)</command> and
         <filename>yum.conf(5)</filename> to learn more, using the
         following commands:
       </para>
 <screen>
-<userinput>
-man yum man yum.conf
+<userinput>man yum
+man yum.conf
 </userinput>
 </screen>
       <indexterm>
-        <primary>yum, Websites</primary>
+        <primary>yum</primary>
+        <secondary>web sites</secondary>
       </indexterm>
       <indexterm>
-        <primary>yum, mailing lists</primary>
+        <primary>yum</primary>
+        <secondary>mailing lists</secondary>
       </indexterm>
+<!-- Hopefully this is not too confusing below.  This is sort of a -->
+<!-- grammar/usage issue. If you use a variablelist, you don't want to -->
+<!-- use sentences, but rather headings, in the term area.  Alternately, -->
+<!-- if you like sentences, just use a para instead for the whole -->
+<!-- collection of links. [PWF] -->
+      <para>
+        Other useful <command>yum</command> resources on the Internet
+        include:
+      </para>
+
       <variablelist>
         <varlistentry>
           <term>
-          The Website for <command>yum</command> is:
+	    Web home page
 	  </term>
           <listitem>
             <para>
-              <ulink url="http://linux.duke.edu/projects/yum/">http://linux.duke.edu/projects/yum/</ulink>
+              <ulink url="http://linux.duke.edu/projects/yum/"/>
             </para>
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term>
-  The mailing list for <command>yum</command> users is:
-         </term>
+	    Users mailing list
+	  </term>
           <listitem>
             <para>
-              <ulink url="https://lists.dulug.duke.edu/mailman/listinfo/yum/">https://lists.dulug.duke.edu/mailman/listinfo/yum/</ulink>
+              <ulink url="https://lists.dulug.duke.edu/mailman/listinfo/yum/"/>
             </para>
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term>
-The archive for the <command>yum</command> development mailing list is:
-</term>
+	    Development mailing list
+	  </term>
           <listitem>
             <para>
-              <ulink url="https://lists.dulug.duke.edu/pipermail/yum-devel/">https://lists.dulug.duke.edu/pipermail/yum-devel/</ulink>
+              <ulink url="https://lists.dulug.duke.edu/pipermail/yum-devel/"/>
             </para>
           </listitem>
         </varlistentry>
@@ -190,7 +204,8 @@
     <section id="sn-about-packages">
       <title>About Packages</title>
       <indexterm>
-        <primary>packages, defined</primary>
+        <primary>packages</primary>
+	<secondary>defined</secondary>
       </indexterm>
       <para>
         All of the software and documentation prepared for use with
@@ -206,12 +221,12 @@
 
       <para>
         Packages also include a digital signature to prove their source.
-        This digital signature is verified by software management
-        utilities by using a GPG <firstterm>public key</firstterm>. The
-        <command>yum</command> and <command>rpm</command> utilities
-        share a common <firstterm>keyring</firstterm> that stores all of
-        the public keys for the package sources approved by the system
-        administrator.
+	Software management utilities verify this digital signature by
+	using a GPG <firstterm>public key</firstterm>. The
+	<command>yum</command> and <command>rpm</command> utilities
+	share a common <firstterm>keyring</firstterm> that stores all of
+	the public keys for approved package sources. The system
+	administrator configures these approved package sources.
       </para>
     </section>