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, 11 insertions, 5 deletions

diff --git a/chapter08/python.xml b/chapter08/python.xml
index 76530d782..1af9e0db9 100644
--- a/chapter08/python.xml
+++ b/chapter08/python.xml
@@ -93,11 +93,17 @@
 <screen><userinput remap="install">make install</userinput></screen>
 
     <para>In serveral places we use the <command>pip3</command> command to
-    install Python 3 programs and modules for all users as root. This conflicts
-    with the Python developers recommendation to build packages in a virtual
-    environment as a regular user. To this end, a multi-line warning is
-    written when using <command>pip3</command> as the root user.  If desired,
-    supress this warning by running the following command:</para>
+    install Python 3 programs and modules for all users as
+    <systemitem class='username'>root</systemitem>. This conflicts
+    with the Python developers recommendation to install packages into a
+    virtual environment or the home directory of a regular user (by running
+    <command>pip3</command> as this user). To this end, a multi-line warning
+    is written when using <command>pip3</command> as the
+    <systemitem class='username'>root</systemitem> user.  The main reason
+    of this recommendation is for avoiding a conflict with the system
+    package manager (<command>dpkg</command> for example), but LFS does not
+    have a system-wide package manager so this is not a problem.  If desired,
+    suppress this warning by running the following command:</para>
 
 <screen><userinput remap="install">sed -e '/def warn_if_run_as_root/a\    return' \
     -i /usr/lib/python3.10/site-packages/pip/_internal/cli/req_command.py