[Libre-soc-bugs] [Bug 671] convert spec pseudocode to use XLEN width

[bugzilla-daemon at libre-soc.org]

https://bugs.libre-soc.org/show_bug.cgi?id=671

--- Comment #21 from Luke Kenneth Casson Leighton <lkcl at lkcl.net> ---
https://libre-soc.org/irclog/%23libre-soc.2021-08-25.log.html#t2021-08-25T07:54:08

discussion about adding new "helper" routines.  if this was not a
specification that required a Formal Process for submitting (and
voting on) by an independent Foundation (OPF) i would say "yes great
idea" immediately to creating as many "helper" routines as we like
and need.

however as a *specification* the practice of creating references
that need the reader to have read a second page (somewhere buried
in a 1,300 page document) where they have no idea how to even find
the information that they need, this makes the specification hostile
to read.

bottom line, it's not just "pseudocode", we cannot just think as
programmers (only), we have to forward-think:

1) "how will this be received by the OpenPOWER Foundation ISA Working Group"
2) "how will users with near-zero-prior knowledge react to reading this"

-- 
You are receiving this mail because:
You are on the CC list for the bug.