Merge branch 'MatrixSpaceCFM' into matrix_keys

.devcontainer/portability-ubuntu-trusty-toolchain-gcc_9-minimal/devcontainer.json → .devcontainer/portability-fedora-40-minimal/devcontainer.json

@@ -3,12 +3,12 @@
 //      from .devcontainer/portability-devcontainer.json.in
 // See https://aka.ms/devcontainer.json for format details.
 {
-    "name": "ubuntu-trusty-toolchain-gcc_9-minimal (≥ 8-core)",
+    "name": "fedora-40-minimal (≥ 8-core)",
     "build": {
         "dockerfile": "portability-Dockerfile",
         // See tox.ini for definitions
         "args": {
-            "SYSTEM_FACTOR": "ubuntu-trusty-toolchain-gcc_9",
+            "SYSTEM_FACTOR": "fedora-40",
             "PACKAGE_FACTOR": "minimal",
             "DOCKER_TARGET": "with-targets",
             "DOCKER_TAG": "dev"

.devcontainer/portability-ubuntu-trusty-toolchain-gcc_9-standard/devcontainer.json → .devcontainer/portability-fedora-40-standard/devcontainer.json

@@ -3,12 +3,12 @@
 //      from .devcontainer/portability-devcontainer.json.in
 // See https://aka.ms/devcontainer.json for format details.
 {
-    "name": "ubuntu-trusty-toolchain-gcc_9-standard (≥ 8-core)",
+    "name": "fedora-40-standard (≥ 8-core)",
     "build": {
         "dockerfile": "portability-Dockerfile",
         // See tox.ini for definitions
         "args": {
-            "SYSTEM_FACTOR": "ubuntu-trusty-toolchain-gcc_9",
+            "SYSTEM_FACTOR": "fedora-40",
             "PACKAGE_FACTOR": "standard",
             "DOCKER_TARGET": "with-targets",
             "DOCKER_TAG": "dev"

.devcontainer/portability-opensuse-15.3-gcc_11-python3.9-minimal/devcontainer.json → .devcontainer/portability-gentoo-python3.12-minimal/devcontainer.json

@@ -3,12 +3,12 @@
 //      from .devcontainer/portability-devcontainer.json.in
 // See https://aka.ms/devcontainer.json for format details.
 {
-    "name": "opensuse-15.3-gcc_11-python3.9-minimal (≥ 8-core)",
+    "name": "gentoo-python3.12-minimal (≥ 8-core)",
     "build": {
         "dockerfile": "portability-Dockerfile",
         // See tox.ini for definitions
         "args": {
-            "SYSTEM_FACTOR": "opensuse-15.3-gcc_11-python3.9",
+            "SYSTEM_FACTOR": "gentoo-python3.12",
             "PACKAGE_FACTOR": "minimal",
             "DOCKER_TARGET": "with-targets",
             "DOCKER_TAG": "dev"

.devcontainer/portability-opensuse-15.3-gcc_11-python3.9-standard/devcontainer.json → .devcontainer/portability-gentoo-python3.12-standard/devcontainer.json

@@ -3,12 +3,12 @@
 //      from .devcontainer/portability-devcontainer.json.in
 // See https://aka.ms/devcontainer.json for format details.
 {
-    "name": "opensuse-15.3-gcc_11-python3.9-standard (≥ 8-core)",
+    "name": "gentoo-python3.12-standard (≥ 8-core)",
     "build": {
         "dockerfile": "portability-Dockerfile",
         // See tox.ini for definitions
         "args": {
-            "SYSTEM_FACTOR": "opensuse-15.3-gcc_11-python3.9",
+            "SYSTEM_FACTOR": "gentoo-python3.12",
             "PACKAGE_FACTOR": "standard",
             "DOCKER_TARGET": "with-targets",
             "DOCKER_TAG": "dev"

.devcontainer/portability-opensuse-15.4-gcc_11-python3.10-minimal/devcontainer.json → .devcontainer/portability-linuxmint-21.3-minimal/devcontainer.json

@@ -3,12 +3,12 @@
 //      from .devcontainer/portability-devcontainer.json.in
 // See https://aka.ms/devcontainer.json for format details.
 {
-    "name": "opensuse-15.4-gcc_11-python3.10-minimal (≥ 8-core)",
+    "name": "linuxmint-21.3-minimal (≥ 8-core)",
     "build": {
         "dockerfile": "portability-Dockerfile",
         // See tox.ini for definitions
         "args": {
-            "SYSTEM_FACTOR": "opensuse-15.4-gcc_11-python3.10",
+            "SYSTEM_FACTOR": "linuxmint-21.3",
             "PACKAGE_FACTOR": "minimal",
             "DOCKER_TARGET": "with-targets",
             "DOCKER_TAG": "dev"

.devcontainer/portability-opensuse-15.4-gcc_11-python3.10-standard/devcontainer.json → .devcontainer/portability-linuxmint-21.3-standard/devcontainer.json

@@ -3,12 +3,12 @@
 //      from .devcontainer/portability-devcontainer.json.in
 // See https://aka.ms/devcontainer.json for format details.
 {
-    "name": "opensuse-15.4-gcc_11-python3.10-standard (≥ 8-core)",
+    "name": "linuxmint-21.3-standard (≥ 8-core)",
     "build": {
         "dockerfile": "portability-Dockerfile",
         // See tox.ini for definitions
         "args": {
-            "SYSTEM_FACTOR": "opensuse-15.4-gcc_11-python3.10",
+            "SYSTEM_FACTOR": "linuxmint-21.3",
             "PACKAGE_FACTOR": "standard",
             "DOCKER_TARGET": "with-targets",
             "DOCKER_TAG": "dev"

.devcontainer/portability-ubuntu-noble-minimal/devcontainer.json

@@ -0,0 +1,25 @@
+// The command "tox -e update_docker_platforms"
+//   creates .devcontainer/portability-*-*/devcontainer.json
+//      from .devcontainer/portability-devcontainer.json.in
+// See https://aka.ms/devcontainer.json for format details.
+{
+    "name": "ubuntu-noble-minimal (≥ 8-core)",
+    "build": {
+        "dockerfile": "portability-Dockerfile",
+        // See tox.ini for definitions
+        "args": {
+            "SYSTEM_FACTOR": "ubuntu-noble",
+            "PACKAGE_FACTOR": "minimal",
+            "DOCKER_TARGET": "with-targets",
+            "DOCKER_TAG": "dev"
+        }
+    },
+    "containerEnv": {
+        "MAKE": "make -j4"
+    },
+    "onCreateCommand": ".devcontainer/onCreate.sh",
+    "updateContentCommand": ".devcontainer/portability-updateContent.sh",
+    "extensions": [
+        "ms-python.python"
+    ]
+}

.devcontainer/portability-ubuntu-noble-minimal/portability-Dockerfile

@@ -0,0 +1 @@
+../portability-Dockerfile

.devcontainer/portability-ubuntu-noble-standard/devcontainer.json

@@ -0,0 +1,25 @@
+// The command "tox -e update_docker_platforms"
+//   creates .devcontainer/portability-*-*/devcontainer.json
+//      from .devcontainer/portability-devcontainer.json.in
+// See https://aka.ms/devcontainer.json for format details.
+{
+    "name": "ubuntu-noble-standard (≥ 8-core)",
+    "build": {
+        "dockerfile": "portability-Dockerfile",
+        // See tox.ini for definitions
+        "args": {
+            "SYSTEM_FACTOR": "ubuntu-noble",
+            "PACKAGE_FACTOR": "standard",
+            "DOCKER_TARGET": "with-targets",
+            "DOCKER_TAG": "dev"
+        }
+    },
+    "containerEnv": {
+        "MAKE": "make -j4"
+    },
+    "onCreateCommand": ".devcontainer/onCreate.sh",
+    "updateContentCommand": ".devcontainer/portability-updateContent.sh",
+    "extensions": [
+        "ms-python.python"
+    ]
+}

.devcontainer/portability-ubuntu-noble-standard/portability-Dockerfile

@@ -0,0 +1 @@
+../portability-Dockerfile

.github/PULL_REQUEST_TEMPLATE.md

@@ -15,7 +15,7 @@
 - [ ] The description explains in detail what this PR is about.
 - [ ] I have linked a relevant issue or discussion.
 - [ ] I have created tests covering the changes.
-- [ ] I have updated the documentation accordingly.
+- [ ] I have updated the documentation and checked the documentation preview.
 
 ### :hourglass: Dependencies
 

.github/workflows/build.yml

@@ -15,7 +15,7 @@ on:
       platform:
         description: 'Platform'
         required: true
-        default: 'ubuntu-focal-standard'
+        default: 'ubuntu-jammy-standard'
       docker_tag:
         description: 'Docker tag'
         required: true
@@ -52,7 +52,7 @@ jobs:
 
   build:
     runs-on: ubuntu-latest
-    container: ghcr.io/sagemath/sage/sage-${{ github.event.inputs.platform || 'ubuntu-focal-standard' }}-with-targets:${{ github.event.inputs.docker_tag || 'dev'}}
+    container: ghcr.io/sagemath/sage/sage-${{ github.event.inputs.platform || 'ubuntu-jammy-standard' }}-with-targets:${{ github.event.inputs.docker_tag || 'dev'}}
     needs: [get_ci_fixes]
     steps:
       - name: Checkout
@@ -93,16 +93,16 @@ jobs:
           ./bootstrap && make build
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Build modularized distributions
         if: (success() || failure()) && steps.worktree.outcome == 'success'
         run: make V=0 tox && make SAGE_CHECK=no pypi-wheels
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Static code check with pyright
         if: (success() || failure()) && steps.worktree.outcome == 'success'
@@ -137,8 +137,8 @@ jobs:
           ./bootstrap && make doc-clean doc-uninstall sagelib-clean && git clean -fx src/sage && ./config.status
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4
+          SAGE_NUM_THREADS: 4
 
       - name: Build
         # This step is needed because building the modularized distributions installs some optional packages,
@@ -149,8 +149,8 @@ jobs:
           make build
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       # Testing
 
@@ -161,16 +161,16 @@ jobs:
           ./sage -t --new -p2
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Test modularized distributions
         if: (success() || failure()) && steps.build.outcome == 'success'
         run: make V=0 tox && make pypi-wheels-check
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Check that all modules can be imported
         run: |

.github/workflows/ci-conda.yml

@@ -35,12 +35,12 @@ jobs:
         # environment: [environment, environment-optional]
         conda-env: [environment]
         # On pull requests, only test two jobs:
-        # Ubuntu with Python 3.9, macOS with Python 3.10.
-        # Build & Test currently uses Python 3.11 (on ubuntu-focal).
+        # Ubuntu with Python 3.9, macOS with Python 3.11.
+        # Build & Test currently uses Python 3.10 (on ubuntu-jammy).
         # Together, they cover the supported minor Python versions.
         include: >-
           ${{ github.event_name == 'pull_request'
-                && fromJson('[{"os": "macos", "python": "3.10", "conda-env": "environment"}]')
+                && fromJson('[{"os": "macos", "python": "3.11", "conda-env": "environment"}]')
                 || fromJson('[]') }}
 
     steps:

.github/workflows/ci-linux.yml

@@ -46,7 +46,7 @@ jobs:
       targets: build doc-html
       targets_optional: ptest
       tox_system_factors: >-
-        ["ubuntu-focal"]
+        ["ubuntu-jammy"]
       tox_packages_factors: >-
         ["standard"]
       docker_push_repository: ghcr.io/${{ github.repository }}/
@@ -111,18 +111,11 @@ jobs:
         ["ubuntu-jammy",
          "ubuntu-lunar",
          "ubuntu-mantic",
-         "debian-bullseye",
          "debian-bookworm",
          "debian-trixie",
          "debian-sid",
-         "linuxmint-21",
          "linuxmint-21.1",
          "linuxmint-21.2",
-         "fedora-33",
-         "fedora-34",
-         "fedora-35",
-         "fedora-36",
-         "fedora-37",
          "fedora-38",
          "fedora-39",
          "centos-stream-8-python3.9",
@@ -131,11 +124,9 @@ jobs:
          "gentoo-python3.10",
          "gentoo-python3.11",
          "archlinux-latest",
-         "opensuse-15.4-gcc_11-python3.10",
          "opensuse-15.5-gcc_11-python3.11",
          "opensuse-tumbleweed-python3.10",
-         "opensuse-tumbleweed",
-         "debian-bullseye-i386"]
+         "opensuse-tumbleweed"]
       docker_push_repository: ghcr.io/${{ github.repository }}/
       max_parallel: 8
 

.github/workflows/doc-build-pdf.yml

@@ -9,7 +9,7 @@ on:
       platform:
         description: 'Platform'
         required: true
-        default: 'ubuntu-focal-standard'
+        default: 'ubuntu-jammy-standard'
       docker_tag:
         description: 'Docker tag'
         required: true
@@ -46,7 +46,7 @@ jobs:
 
   build-docs-pdf:
     runs-on: ubuntu-latest
-    container: ghcr.io/sagemath/sage/sage-${{ github.event.inputs.platform || 'ubuntu-focal-standard' }}-with-targets:${{ github.event.inputs.docker_tag || 'dev'}}
+    container: ghcr.io/sagemath/sage/sage-${{ github.event.inputs.platform || 'ubuntu-jammy-standard' }}-with-targets:${{ github.event.inputs.docker_tag || 'dev'}}
     needs: [get_ci_fixes]
     steps:
       - name: Checkout
@@ -87,8 +87,8 @@ jobs:
           ./bootstrap && make build
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Build (fallback to non-incremental)
         id: build
@@ -98,8 +98,8 @@ jobs:
           make sagelib-clean && git clean -fx src/sage && ./config.status && make build
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Build docs (PDF)
         id: docbuild
@@ -108,8 +108,8 @@ jobs:
           make doc-clean doc-uninstall; make sagemath_doc_html-build-deps sagemath_doc_pdf-no-deps
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Copy docs
         id: copy

.github/workflows/doc-build.yml

@@ -41,7 +41,7 @@ jobs:
 
   build-docs:
     runs-on: ubuntu-latest
-    container: ghcr.io/sagemath/sage/sage-ubuntu-focal-standard-with-targets:dev
+    container: ghcr.io/sagemath/sage/sage-ubuntu-jammy-standard-with-targets:dev
     needs: [get_ci_fixes]
     steps:
       - name: Checkout
@@ -95,8 +95,8 @@ jobs:
           ./bootstrap && make sagemath_doc_html-build-deps
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Build (fallback to non-incremental)
         id: build
@@ -106,8 +106,8 @@ jobs:
           make sagelib-clean && git clean -fx src/sage && ./config.status && make sagemath_doc_html-build-deps
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Build docs
         id: docbuild
@@ -124,8 +124,8 @@ jobs:
           ./config.status && make sagemath_doc_html-no-deps
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Copy docs
         id: copy
@@ -169,8 +169,8 @@ jobs:
           ./config.status && make sagemath_doc_html-no-deps sagemath_doc_pdf-no-deps
         working-directory: ./worktree-image
         env:
-          MAKE: make -j2 --output-sync=recurse
-          SAGE_NUM_THREADS: 2
+          MAKE: make -j4 --output-sync=recurse
+          SAGE_NUM_THREADS: 4
 
       - name: Copy live doc
         id: copylivedoc