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

bugzilla-daemon at libre-soc.org bugzilla-daemon at libre-soc.org
Wed Aug 25 13:18:24 BST 2021


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.


More information about the libre-soc-bugs mailing list