Changeset 104ff4e for general/prog/docutils.xml

Timestamp:

01/04/2023 06:05:12 PM (16 months ago)

Author:

Pierre Labastie <pierre.labastie@…>

Branches:

qt5new

Children:

c0ef2f9

Parents:

1daaab6d (diff), 811d39b (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge branch 'trunk' into qt5new

File:

• general/prog/docutils.xml (modified) (5 diffs)

general/prog/docutils.xml

@@ -7 +7 @@
   <!ENTITY docutils-download-http "https://downloads.sourceforge.net/docutils/docutils-&docutils-version;.tar.gz">
   <!ENTITY docutils-download-ftp  " ">
-  <!ENTITY docutils-md5sum        "ca5827e2432fd58f4c8d74a6591135de">
-  <!ENTITY docutils-size          "1.9 MB">
+  <!ENTITY docutils-md5sum        "0afa992a6e93db892107c3f087d0d9df">
+  <!ENTITY docutils-size          "2.0 MB">
   <!ENTITY docutils-buildsize     "12 MB">
   <!ENTITY docutils-time          "less than 0.1 SBU">
@@ -31 +31 @@
       </para>
 
-      &lfs110a_checked;
+      &lfs112_checked;
 
       <bridgehead renderas="sect4">Package Information</bridgehead>
@@ -91 +91 @@
       </para>
 
-<screen><userinput>python3 setup.py build</userinput></screen>
+<screen><userinput>pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
 
       <para>
         To install the <application>Python</application> applications
-        run the following as the
-        <systemitem class="username">root</systemitem> user:
+        run the following as the &root; user:
       </para>
 
-<screen role="root"><userinput>python3 setup.py install --optimize=1 &amp;&amp;
+<screen role="root"><userinput>pip3 install --no-index --find-links dist --no-cache-dir --no-user docutils &amp;&amp;
 
 for f in /usr/bin/rst*.py; do
@@ -105 +104 @@
 done</userinput></screen>
 
+      <!-- FHS 3.0 section 4.4.2:
+           "There must be no subdirectories in /usr/bin."
+           But pip maintainers closed this as WONTFIX:
+           https://github.com/pypa/pip/issues/6906 -->
+      <para>
+        To reduce the time needed for loading Python scripts,
+        <command>pip3 install</command> will compile the scripts with
+        extension <filename class='extension'>.py</filename> into byte code
+        and save the result into
+        <filename class='extension'>.pyc</filename> files in the directory
+        <filename class='directory'>__pycache__</filename>.
+        But this package installs <filename class='extension'>.py</filename>
+        scripts into <filename class='directory'>/usr/bin</filename>.
+        So the byte code files for them will be installed into
+        <filename class='directory'>/usr/bin/__pycache__</filename>, which
+        is not allowed by FHS.  Still as the &root; user, remove this
+        directory:
+      </para>
+
+<screen role="root"><userinput>rm -rfv /usr/bin/__pycache__</userinput></screen>
     </sect3>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/pip3-cmd-explain.xml"/>
 
     <sect3 role="content">
@@ -125 +147 @@
           </seg>
           <seg>
-            /usr/lib/python&python3-majorver;/site-packages/docutils
+            /usr/lib/python&python3-majorver;/site-packages/docutils{,-&docutils-version;.dist-info}
           </seg>
         </seglistitem>