[Libre-soc-bugs] [Bug 745] OP_TERNLOG instruction

bugzilla-daemon at libre-soc.org bugzilla-daemon at libre-soc.org
Fri Dec 17 16:43:17 GMT 2021


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

--- Comment #50 from Luke Kenneth Casson Leighton <lkcl at lkcl.net> ---
(In reply to Jacob Lifshay from comment #49)
> (In reply to Luke Kenneth Casson Leighton from comment #48)
> > oh: and definitely don't use docstrings *under* (after) a line of code
> > to explain it
> 
> But that's the official Python standard for documenting attributes in a way
> that tools can extract the docstrings:
> https://www.python.org/dev/peps/pep-0257/

A: because it's totally counter-intuitive
Q: why is it awful to have the docstring after the attribute it refers to?

> > String literals occurring immediately after a simple assignment at the top
> > level of a module, class, or __init__ method are called "attribute
> > docstrings".

i've never seen this used - ever - in 20 years.  it's great that you're
reading the specs, but some things like this just in practice never get used,
and they'll confuse the hell out people.

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


More information about the libre-soc-bugs mailing list