Skip to content

Conversation

a4lg
Copy link

@a4lg a4lg commented Aug 30, 2025

This PR directly corresponds to rust-lang/rust#145948 but commit 2 through 4 fixes some minor issues outside the scope of that PR (still in this PR because we have to make the reference consistent).

@rustbot rustbot added the S-waiting-on-review Status: The marked PR is awaiting review from a maintainer label Aug 30, 2025
@a4lg a4lg force-pushed the riscv-extensions-2025.1 branch from 1ef6f06 to c60bc59 Compare August 30, 2025 03:14
a4lg added 4 commits August 30, 2025 03:17
The `Zb` extension does not exist and we instead have the `B` extension
which is a superset of the three subextensions: `Zba`, `Zbb` and `Zbs`.

This commit fixes this issue and updates the reference URL to the source
code of the latest ratified ISA Manual (version 20250508).

To align with rust-lang/rust#145948,
this commit performs rename, not removal.
This is the latest ratified ISA Manual version and more importantly,
some individual documents are merged into this.

So, this commit consistently use this Manual (this version) where possible.

Along with this, this commit substitutes link IDs from `rv-zb-*` to `rv-*`
because `rv-zb-*` will look like the different document (bit-manipulation)
is referenced.
rust-lang/rust#140139 changed the target feature implication without
updating the Reference.

This commit fixes this issue.
Because unstable "B" (incorrectly named as `zb`) was there, this commit
adds 28 minus one ("B") new extensions to be stabilized.

This commit directly corresponds to rust-lang/rust#145948.

References:

1.  RISC-V Instruction Set Manual (version 20250508):
    <https://github.com/riscv/riscv-isa-manual/tree/20250508>
2.  RISC-V Profiles (version 1.0 - RVA23 is not stabilized at the time):
    <https://github.com/riscv/riscv-profiles/tree/v1.0>
3.  RISC-V Profiles (RVA23/RVB23-ratified version):
    <https://github.com/riscv/riscv-profiles/tree/rva23-rvb23-ratified>
@a4lg a4lg force-pushed the riscv-extensions-2025.1 branch from 25d43f0 to a35f1c8 Compare August 30, 2025 04:18
@a4lg
Copy link
Author

a4lg commented Aug 30, 2025

Possible Consideration

Some platform behavior extensions are hard to make a short, concise summary.

Do we prefer to keep long(er than usual) descriptions? Or, do we just link to the RISC-V Profiles documentation and let it explain?

My Current Position

I prefer the latter if allowed but mdbook design is confirmed not broken so the current approach (long descriptions) is okay for me.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
S-waiting-on-review Status: The marked PR is awaiting review from a maintainer
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants