From 53b0e5e9330f54f2a520955d8ef5f79d68ce9034 Mon Sep 17 00:00:00 2001 From: aryanputta <176622462+aryanputta@users.noreply.github.com> Date: Tue, 11 Aug 2026 11:53:45 -0400 Subject: [PATCH 1/7] Upgrade documentation environments to Sphinx 9 --- cuda_bindings/pixi.toml | 2 +- cuda_core/pixi.toml | 2 +- cuda_pathfinder/pixi.toml | 2 +- cuda_python/docs/environment-docs.yml | 2 +- toolshed/setup-docs-env.sh | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/cuda_bindings/pixi.toml b/cuda_bindings/pixi.toml index 0d46eee8fcb..f647aa5e2bc 100644 --- a/cuda_bindings/pixi.toml +++ b/cuda_bindings/pixi.toml @@ -37,7 +37,7 @@ pyclibrary = "*" pydata-sphinx-theme = "*" pytest = "*" scipy = "*" -sphinx = "<8.2.0" +sphinx = ">=9,<10" sphinx-copybutton = "*" sphinx-toolbox = "*" diff --git a/cuda_core/pixi.toml b/cuda_core/pixi.toml index 5e626557174..cecdf63bd0c 100644 --- a/cuda_core/pixi.toml +++ b/cuda_core/pixi.toml @@ -101,7 +101,7 @@ pip = "*" pydata-sphinx-theme = "*" pytest = "*" scipy = "*" -sphinx = "<8.2.0" +sphinx = ">=9,<10" sphinx-copybutton = "*" myst-nb = "*" enum_tools = "*" diff --git a/cuda_pathfinder/pixi.toml b/cuda_pathfinder/pixi.toml index 7ebcc9644d7..2289e079087 100644 --- a/cuda_pathfinder/pixi.toml +++ b/cuda_pathfinder/pixi.toml @@ -31,7 +31,7 @@ pyclibrary = "*" pydata-sphinx-theme = "*" pytest = "*" scipy = "*" -sphinx = "<8.2.0" +sphinx = ">=9,<10" sphinx-copybutton = "*" sphinx-toolbox = "*" diff --git a/cuda_python/docs/environment-docs.yml b/cuda_python/docs/environment-docs.yml index f48579843fe..b74627aa9e1 100644 --- a/cuda_python/docs/environment-docs.yml +++ b/cuda_python/docs/environment-docs.yml @@ -15,7 +15,7 @@ dependencies: - pydata-sphinx-theme - pytest - scipy - - sphinx <8.2.0 + - sphinx >=9,<10 - sphinx-copybutton - myst-nb - enum_tools diff --git a/toolshed/setup-docs-env.sh b/toolshed/setup-docs-env.sh index 16378725e93..9f32857c92f 100755 --- a/toolshed/setup-docs-env.sh +++ b/toolshed/setup-docs-env.sh @@ -47,7 +47,7 @@ conda create -y -n "${ENV_NAME}" \ pydata-sphinx-theme \ pytest \ scipy \ - "sphinx<8.2.0" \ + "sphinx>=9,<10" \ sphinx-copybutton \ myst-nb \ enum_tools \ From 163ae33de0d4aa4ad097717823ebf4f6fbf6c3d4 Mon Sep 17 00:00:00 2001 From: Aryan Putta Date: Thu, 13 Aug 2026 12:13:16 -0400 Subject: [PATCH 2/7] fix(docs): install Sphinx 9 compatible toolbox --- cuda_bindings/pixi.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/cuda_bindings/pixi.toml b/cuda_bindings/pixi.toml index f647aa5e2bc..2bc0acde58d 100644 --- a/cuda_bindings/pixi.toml +++ b/cuda_bindings/pixi.toml @@ -84,6 +84,7 @@ docs = { features = ["cu13", "docs"], solve-group = "docs" } [feature.docs.pypi-dependencies] nvidia-sphinx-theme = "*" +sphinx-toolbox = ">=4.2.0" # TODO: check if these can be extracted from pyproject.toml [package] From 70c0ca03c8e2187f9f272925ecabc9ef5c6ecea5 Mon Sep 17 00:00:00 2001 From: Aryan Putta Date: Thu, 13 Aug 2026 12:13:19 -0400 Subject: [PATCH 3/7] fix(docs): install Sphinx 9 compatible toolbox --- cuda_core/pixi.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/cuda_core/pixi.toml b/cuda_core/pixi.toml index cecdf63bd0c..c8b2114e9e5 100644 --- a/cuda_core/pixi.toml +++ b/cuda_core/pixi.toml @@ -110,6 +110,7 @@ pyclibrary = "*" [feature.docs.pypi-dependencies] nvidia-sphinx-theme = "*" +sphinx-toolbox = ">=4.2.0" [feature.docs.target.linux.dependencies] make = "*" From 8bc3056c91df50f8621572c48689d4e06a6b7f89 Mon Sep 17 00:00:00 2001 From: Aryan Putta Date: Thu, 13 Aug 2026 12:13:21 -0400 Subject: [PATCH 4/7] fix(docs): install Sphinx 9 compatible toolbox --- cuda_pathfinder/pixi.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/cuda_pathfinder/pixi.toml b/cuda_pathfinder/pixi.toml index 2289e079087..4cb068817a3 100644 --- a/cuda_pathfinder/pixi.toml +++ b/cuda_pathfinder/pixi.toml @@ -55,6 +55,7 @@ docs = { features = ["docs"], solve-group = "docs" } [feature.docs.pypi-dependencies] nvidia-sphinx-theme = "*" +sphinx-toolbox = ">=4.2.0" # TODO: check if these can be extracted from pyproject.toml [package] From c8deb4c8e73c9a09c85b7f67bd95bd6d9b3152b2 Mon Sep 17 00:00:00 2001 From: Aryan Putta Date: Thu, 13 Aug 2026 12:13:24 -0400 Subject: [PATCH 5/7] fix(docs): install Sphinx 9 compatible toolbox --- cuda_python/docs/environment-docs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cuda_python/docs/environment-docs.yml b/cuda_python/docs/environment-docs.yml index b74627aa9e1..8e99755c9f9 100644 --- a/cuda_python/docs/environment-docs.yml +++ b/cuda_python/docs/environment-docs.yml @@ -19,7 +19,7 @@ dependencies: - sphinx-copybutton - myst-nb - enum_tools - - sphinx-toolbox - pyclibrary - pip: - nvidia-sphinx-theme + - sphinx-toolbox>=4.2.0 From 5e7584319a91e449956d16d9a6d3e33eab626ce5 Mon Sep 17 00:00:00 2001 From: Aryan Putta Date: Thu, 13 Aug 2026 12:13:26 -0400 Subject: [PATCH 6/7] fix(docs): install Sphinx 9 compatible toolbox --- toolshed/setup-docs-env.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/toolshed/setup-docs-env.sh b/toolshed/setup-docs-env.sh index 9f32857c92f..cb97e42dcdd 100755 --- a/toolshed/setup-docs-env.sh +++ b/toolshed/setup-docs-env.sh @@ -56,7 +56,7 @@ conda create -y -n "${ENV_NAME}" \ conda activate "${ENV_NAME}" python -m pip install --upgrade pip -python -m pip install nvidia-sphinx-theme +python -m pip install nvidia-sphinx-theme "sphinx-toolbox>=4.2.0" echo echo "✅ Environment '${ENV_NAME}' is ready." From e498397dfd2d81d2c05512da9f35921db22c6549 Mon Sep 17 00:00:00 2001 From: Aryan Putta Date: Fri, 14 Aug 2026 20:30:04 -0400 Subject: [PATCH 7/7] fix(docs): take sphinx-toolbox from PyPI only conda-forge tops out at sphinx-toolbox 4.1.2, which does not support Sphinx 9. Declaring the package in both [feature.docs.dependencies] and [feature.docs.pypi-dependencies] leaves the conda 4.1.2 build in the solve, so the >=4.2.0 requirement never takes effect. Drop the conda entry in all three manifests, matching environment-docs.yml. Signed-off-by: Aryan Putta --- cuda_bindings/pixi.toml | 1 - cuda_core/pixi.toml | 1 - cuda_pathfinder/pixi.toml | 1 - 3 files changed, 3 deletions(-) diff --git a/cuda_bindings/pixi.toml b/cuda_bindings/pixi.toml index cb16175f5e4..ea516ea9d21 100644 --- a/cuda_bindings/pixi.toml +++ b/cuda_bindings/pixi.toml @@ -41,7 +41,6 @@ pytest = "*" scipy = "*" sphinx = ">=9,<10" sphinx-copybutton = "*" -sphinx-toolbox = "*" [feature.cython-tests.dependencies] cython = ">=3.2.5,<3.3" # for tests that exercise APIs from cython diff --git a/cuda_core/pixi.toml b/cuda_core/pixi.toml index 0ff84db4549..e6dfe620cd1 100644 --- a/cuda_core/pixi.toml +++ b/cuda_core/pixi.toml @@ -109,7 +109,6 @@ sphinx = ">=9,<10" sphinx-copybutton = "*" myst-nb = "*" enum_tools = "*" -sphinx-toolbox = "*" pyclibrary = "*" [feature.docs.pypi-dependencies] diff --git a/cuda_pathfinder/pixi.toml b/cuda_pathfinder/pixi.toml index 9949be536ad..41e41bdd265 100644 --- a/cuda_pathfinder/pixi.toml +++ b/cuda_pathfinder/pixi.toml @@ -33,7 +33,6 @@ pytest = "*" scipy = "*" sphinx = ">=9,<10" sphinx-copybutton = "*" -sphinx-toolbox = "*" [feature.cu12.system-requirements] cuda = "12"