Changes in general/prog/python-modules.xml [141ee0a5:3f2db3a6]

File:

• general/prog/python-modules.xml (modified) (5 diffs)

general/prog/python-modules.xml

@@ -9 +9 @@
   <?dbhtml filename="python-modules.html" ?>
 
-  <sect1info>
-    <date>$Date$</date>
-  </sect1info>
 
   <title>Python Modules</title>
@@ -28 +25 @@
     </para>
 
+    <important>
+      <para>
+        In BLFS, we normally build and install Python 3 modules with
+        <command>pip3</command>.  Please take care that the
+        <command>pip3 install</command> commands in the book should be
+        run as &root; unless it's for a Python virtual environment.  Running
+        <command>pip3 install</command> as a non-&root; user may seem to
+        work fine, but it will cause the installed module to be inaccessible by
+        other users.
+      </para>
+      <para>
+        <command>pip3 install</command> will not reinstall an already
+        installed module by default.  For using the
+        <command>pip3 install</command> command to upgrade a module (for
+        example, from meson-0.61.3 to meson-0.62.0), insert
+        <parameter>--upgrade</parameter> into the command line.  If it's really
+        necessary to downgrade a module or reinstall the same version for
+        some reason, insert <parameter>--force-reinstall</parameter> into
+        the command line.
+      </para>
+    </important>
+
     <itemizedlist spacing="compact">
       <listitem>
@@ -36 +55 @@
       <listitem>
         <para>
+          <xref linkend="cython"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="dbus-python"/>
         </para>
@@ -127 +151 @@
         </para>
       </listitem>
-      <listitem>
+      <listitem revision="sysv">
         <para>
           <xref linkend="MarkupSafe"/>
         </para>
       </listitem>
-      <listitem>
+      <listitem revision="sysv">
         <para>
           <xref linkend="Jinja2"/>
@@ -170 +194 @@
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="cython.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     href="dbus-python.xml"/>