src/doc/bootstrap: Parallelize generation of SPKG.rst files

Author: Matthias Koeppe

build/bin/sage-spkg-info

@@ -5,11 +5,16 @@
 #
 #  Assumes SAGE_ROOT is set
 PKG_BASE=$1
+if [ -n "$OUTPUT_DIR" ]; then
+    exec > "$OUTPUT_DIR"/$PKG_BASE.rst
+    echo ".. _spkg_$PKG_BASE:"
+fi
 PKG_SCRIPTS="$SAGE_ROOT/build/pkgs/$PKG_BASE"
 for ext in rst txt; do
     SPKG_FILE="$PKG_SCRIPTS/SPKG.$ext"
     if [ -f "$SPKG_FILE" ]; then
-        sed "1,3s/^ *Sage: Open Source Mathematics Software:/$PKG_BASE:/" "$SPKG_FILE"
+        # for sphinx 4.4 we need to replace all direct links by some "extlink" (issue 33272)
+        sed -e "1,3s/^ *Sage: Open Source Mathematics Software:/$PKG_BASE:/" -e "s|https://github.com/sagemath/sage/issues/\([0-9]*\)|:issue:\`\1\`|g" -e "s|https://arxiv.org/abs/cs/\([0-9]*\)|:arxiv:\`cs/\1\`|g" "$SPKG_FILE"
         break
     fi
 done

src/doc/bootstrap

@@ -190,7 +190,7 @@ All External Packages
 EOF
 
 OUTPUT_INDEX="$OUTPUT_DIR"/index_alph.rst
-cat >> "$OUTPUT_INDEX" <<EOF
+(cat <<EOF
 
 Details of external packages
 ============================
@@ -204,16 +204,12 @@ Packages are in alphabetical order.
 
 EOF
 for PKG_BASE in $(sage-package list --has-file SPKG.rst); do
-            PKG_SCRIPTS=build/pkgs/$PKG_BASE
-            # Instead of just copying, we may want to call
-            # a version of sage-spkg-info to format extra information.
-            # for sphinx 4.4 we need to replace all direct links by some "extlink" (issue 33272)
-
-            (echo ".. _spkg_$PKG_BASE:" && echo && OUTPUT_RST=1 sage-spkg-info $PKG_BASE) | sed -e "s|https://github.com/sagemath/sage/issues/\([0-9]*\)|:issue:\`\1\`|g" -e "s|https://arxiv.org/abs/cs/\([0-9]*\)|:arxiv:\`cs/\1\`|g" > "$OUTPUT_DIR"/$PKG_BASE.rst
-            echo >> "$OUTPUT_INDEX" "   $PKG_BASE"
+    echo "   $PKG_BASE"
 done
-cat >> "$OUTPUT_INDEX" <<EOF
+cat <<EOF
 
 .. default-role::
 
 EOF
+) > "$OUTPUT_INDEX"
+sage-package list --has-file SPKG.rst | OUTPUT_DIR=$OUTPUT_DIR OUTPUT_RST=1 xargs -P 0 -n 1 sage-spkg-info