riscv/riscv-isa-manual

Priv spec chapter 5 italics issues

bcstrongx opened this issue · 0 comments

Non-normative text here has extra underscores.
Ordinarily, each_ miregi _will access register state, access read-only 0 state, or raise an illegal instruction exception.

Same thing here:
Ordinarily, each_ siregi _will access register state, access read-only 0 state, or, unless executing in a virtual machine (covered in the next section), raise an illegal instruction exception.

And here:
Ordinarily, each_ vsiregi _will access register state, access read-only 0 state, or raise an exception (either an illegal instruction exception or, for select accesses from VS-mode, a virtual instruction exception).

These all relate to the use of a register name with a trailing variable i. Normally the i is italicized while the name is not, but in these italicized non-normative blocks the intent was the opposite: the name is italicized and the i is not. You can see this in the original spec:
https://github.com/riscvarchive/riscv-indirect-csr-access/releases/download/v1.0.0/riscv-indirect-csr-access-v1.0.0.pdf

Also, I really don't like how italicized characters within backticks (e.g., mireg__i__) end up simply not bold. It would be nice if there was actual slant, to make clear that the character is a variable.