[Python-checkins] r83013 - in python/branches/release27-maint: Doc/library/dis.rst Misc/NEWS
brett.cannon
python-checkins at python.org
Wed Jul 21 11:52:10 CEST 2010
Author: brett.cannon
Date: Wed Jul 21 11:52:10 2010
New Revision: 83013
Log:
Backport r82456.
Modified:
python/branches/release27-maint/Doc/library/dis.rst
python/branches/release27-maint/Misc/NEWS
Modified: python/branches/release27-maint/Doc/library/dis.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/dis.rst (original)
+++ python/branches/release27-maint/Doc/library/dis.rst Wed Jul 21 11:52:10 2010
@@ -6,11 +6,17 @@
:synopsis: Disassembler for Python bytecode.
-The :mod:`dis` module supports the analysis of Python :term:`bytecode` by disassembling
-it. Since there is no Python assembler, this module defines the Python assembly
-language. The Python bytecode which this module takes as an input is defined
-in the file :file:`Include/opcode.h` and used by the compiler and the
-interpreter.
+The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by
+disassembling it. The CPython bytecode which this module takes as an
+input is defined in the file :file:`Include/opcode.h` and used by the compiler
+and the interpreter.
+
+.. impl-detail::
+
+ Bytecode is an implementation detail of the CPython interpreter! No
+ guarantees are made that bytecode will not be added, removed, or changed
+ between versions of Python. Use of this module should not be considered to
+ work across Python VMs or Python releases.
Example: Given the function :func:`myfunc`::
Modified: python/branches/release27-maint/Misc/NEWS
==============================================================================
--- python/branches/release27-maint/Misc/NEWS (original)
+++ python/branches/release27-maint/Misc/NEWS Wed Jul 21 11:52:10 2010
@@ -59,6 +59,11 @@
- Issue #8605: Skip test_gdb if Python is compiled with optimizations.
+Documentation
+-------------
+
+- Issue 7829: Document in dis that bytecode is an implementation detail.
+
What's New in Python 2.7?
=========================
More information about the Python-checkins
mailing list