text fixes for wheel change

* Add description for "wheel" command
* Explain why pip3 warning does not matter for us
* Format and typo fixes

1 files changed, 22 insertions, 5 deletions

diff --git a/chapter08/wheel.xml b/chapter08/wheel.xml
index 78fa94fd8..f15824ad5 100644
--- a/chapter08/wheel.xml
+++ b/chapter08/wheel.xml
@@ -23,7 +23,7 @@
   <sect2 role="package">
     <title/>
 
-    <para>Wheel is a Python library that implements the reference
+    <para>Wheel is a Python library that is the reference
     implementation of the Python wheel packaging standard.</para>
 
     <segmentedlist>
@@ -50,7 +50,7 @@
       <varlistentry>
         <term><command>install</command></term>
         <listitem>
-           <para>Install the package</para>
+           <para>Install the package.</para>
         </listitem>
       </varlistentry>
 
@@ -79,16 +79,33 @@
     <title>Contents of Wheel</title>
 
     <segmentedlist>
-      <segtitle>Installed module</segtitle>
+      <segtitle>Installed program</segtitle>
       <segtitle>Installed directory</segtitle>
 
       <seglistitem>
-        <seg>wheel.py</seg>
+        <seg>wheel</seg>
         <seg>/usr/lib/python&python-minor;/site-packages/wheel</seg>
       </seglistitem>
-
     </segmentedlist>
 
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="wheel-wheel">
+        <term><command>wheel</command></term>
+        <listitem>
+          <para>
+            is an utility to unpack, pack, or convert wheel packages
+          </para>
+          <indexterm zone="ch-system-wheel">
+            <primary sortas="b-wheel">wheel</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
   </sect2>
 
 </sect1>