[docs] Documenting that dis is an implementation detail
Éric Araujo
merwok at netwok.org
Fri Jul 2 12:17:58 CEST 2010
Hello documenters
>From a python-dev thread:
Martin v. Löwis:
> The dis module is deliberately (*) not part of the Python language and
> standard library; it's an implementation detail (as is the func_code
> attribute, and the code object). [...]
>
> (*) Unfortunately, the documentation fails to mention that, probably
> because it's too obvious.
Maciej Fijalkowski
> Even more, Jython and IronPython don't have Python bytecode at all and
> they're considered python implementations.
The dis documentation should mention that it’s not authoritative for
Python, just a tool for CPython. I may be able to propose a patch this
week-end.
Do we need to open a bug report to track other mentions of bytecode that
fail to mention it’s an implementation detail?
Regards
More information about the docs
mailing list