summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2009-01-01 12:09:40 (GMT)
committerGeorg Brandl <georg@python.org>2009-01-01 12:09:40 (GMT)
commit775c30706882291fe6385066899f702f768ed95f (patch)
treee64dacc8ba3e477eb74ed44e26761c94226bddb2 /Doc/library
parent2adde0551a51002c9a43bfabf684be0c960ed192 (diff)
downloadcpython-775c30706882291fe6385066899f702f768ed95f.zip
cpython-775c30706882291fe6385066899f702f768ed95f.tar.gz
cpython-775c30706882291fe6385066899f702f768ed95f.tar.bz2
#4222: document dis.findlabels() and dis.findlinestarts() and
put them into dis.__all__.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/dis.rst17
1 files changed, 15 insertions, 2 deletions
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index e9cbb13..909e229 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -64,10 +64,23 @@ The :mod:`dis` module defines the following functions and constants:
.. function:: disco(code[, lasti])
- A synonym for disassemble. It is more convenient to type, and kept for
- compatibility with earlier Python releases.
+ A synonym for :func:`disassemble`. It is more convenient to type, and kept
+ for compatibility with earlier Python releases.
+.. function:: findlinestarts(code)
+
+ This generator function uses the ``co_firstlineno`` and ``co_lnotab``
+ attributes of the code object *code* to find the offsets which are starts of
+ lines in the source code. They are generated as ``(offset, lineno)`` pairs.
+
+
+.. function:: findlabels(code)
+
+ Detect all offsets in the code object *code* which are jump targets, and
+ return a list of these offsets.
+
+
.. data:: opname
Sequence of operation names, indexable using the bytecode.