Skip to content

Commit d6f93ee

Browse files
committed
docs: development: add GCC version section, clarify Python version matrix
Signed-off-by: Trevor Gamblin <tgamblin@baylibre.com>
1 parent eef769f commit d6f93ee

1 file changed

Lines changed: 15 additions & 6 deletions

File tree

docs/development.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -64,15 +64,17 @@ jobs:
6464

6565
By default, riscv64 wheel should be built for a matrix covering the four latest
6666
released Python versions. As of July 14th, 2026, this includes Pythons 3.11,
67-
3.12, 3.13, and 3.14. There is also a freethreaded version of Python 3.14t which
68-
we include. Some wheels have previously been built for 3.13t, but since this was
69-
an experimental version with limited support we avoid it now.
67+
3.12, 3.13, and 3.14 (along with 3.14t, the freethreaded equivalent). Some
68+
wheels have previously been built for 3.13t, but since this was an experimental
69+
version with limited support we avoid it now. This makes our target matrix:
70+
71+
`['3.11', '3.12', '3.13', '3.14', '3.14t']`
7072

7173
It is worth noting that NumPy releases follow a minimum supported version
7274
pattern that implies a narrower matrix - for example, as of NumPy 2.5.0, only
73-
Python 3.12 and newer are supported. If we follow this precedent, then our
74-
entire riscv64 build matrix consists of `3.12`, `3.13`, `3.14`, and `3.14t`
75-
until `3.15` releases.
75+
Python 3.12 and newer are supported. However, we cannot ensure that all users
76+
will choose 2.5.0 or greater for their projects, so until Python 3.15 is
77+
released we should continue building for 3.11.
7678

7779
### uv
7880

@@ -293,3 +295,10 @@ similar, so that it uses the `arch` field:
293295
name: wheels-linux-${{ matrix.platform.arch }}
294296
path: dist
295297
```
298+
299+
### GCC Version Mismatches
300+
301+
Some packages may require GCC 14 or later to compile for riscv64. If your build
302+
requires GCC 14, ensure that you are either using a cibuildwheel container
303+
approach, or (if the project doesn't use cibuildwheel) have an appropriate
304+
workaround in place, since the RISC-V runners currently ship GCC 13 by default.

0 commit comments

Comments
 (0)