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

[bugzilla-daemon at libre-soc.org]

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

--- Comment #51 from Jacob Lifshay <programmerjake at gmail.com> ---
(In reply to Luke Kenneth Casson Leighton from comment #50)
> (In reply to Jacob Lifshay from comment #49)
> > (In reply to Luke Kenneth Casson Leighton from comment #48)
> > > 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.

They do get used pretty often:
https://repo.or.cz/docutils.git/blob/3c60c830ac4cafaede096539d09c45f51544686a:/docutils/docutils/transforms/frontmatter.py#l382

https://github.com/pdoc3/pdoc/blob/4aa70de2221a34a3003a7e5f52a9b91965f0e359/pdoc/__init__.py#L502

Also, probably most importantly, they're the format that basically *all* tools
understand, sphinx/docutils, pdoc3, vscode, etc.

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