diff options
author | Georg Brandl <georg@python.org> | 2007-10-21 10:24:20 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2007-10-21 10:24:20 (GMT) |
commit | 63fa16832617bfad010e3e70e7f10f713afd7593 (patch) | |
tree | 2f24ea291751a34d0b556833b5a1c3c353fb23a8 /Doc/library | |
parent | fa6179701c0dd7f2ecc21fe0ff6204a4e865094f (diff) | |
download | cpython-63fa16832617bfad010e3e70e7f10f713afd7593.zip cpython-63fa16832617bfad010e3e70e7f10f713afd7593.tar.gz cpython-63fa16832617bfad010e3e70e7f10f713afd7593.tar.bz2 |
Unify "byte code" to "bytecode". Also sprinkle :term: markup for it.
Diffstat (limited to 'Doc/library')
-rw-r--r-- | Doc/library/compiler.rst | 4 | ||||
-rw-r--r-- | Doc/library/dis.rst | 46 | ||||
-rw-r--r-- | Doc/library/functions.rst | 2 | ||||
-rw-r--r-- | Doc/library/inspect.rst | 2 | ||||
-rw-r--r-- | Doc/library/parser.rst | 2 |
5 files changed, 28 insertions, 28 deletions
diff --git a/Doc/library/compiler.rst b/Doc/library/compiler.rst index 96f4fc3..6d42dc9 100644 --- a/Doc/library/compiler.rst +++ b/Doc/library/compiler.rst @@ -10,8 +10,8 @@ Python compiler package The Python compiler package is a tool for analyzing Python source code and generating Python bytecode. The compiler contains libraries to generate an -abstract syntax tree from Python source code and to generate Python bytecode -from the tree. +abstract syntax tree from Python source code and to generate Python +:term:`bytecode` from the tree. The :mod:`compiler` package is a Python source to bytecode translator written in Python. It uses the built-in parser and standard :mod:`parser` module to diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index e8e5cf3..c31a779 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -1,14 +1,14 @@ -:mod:`dis` --- Disassembler for Python byte code -================================================ +:mod:`dis` --- Disassembler for Python bytecode +=============================================== .. module:: dis - :synopsis: Disassembler for Python byte code. + :synopsis: Disassembler for Python bytecode. -The :mod:`dis` module supports the analysis of Python byte code by disassembling +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 byte code which this module takes as an input is defined +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. @@ -35,7 +35,7 @@ The :mod:`dis` module defines the following functions and constants: Disassemble the *bytesource* object. *bytesource* can denote either a module, a class, a method, a function, or a code object. For a module, it disassembles all functions. For a class, it disassembles all methods. For a single code - sequence, it prints one line per byte code instruction. If no object is + sequence, it prints one line per bytecode instruction. If no object is provided, it disassembles the last traceback. @@ -70,12 +70,12 @@ The :mod:`dis` module defines the following functions and constants: .. data:: opname - Sequence of operation names, indexable using the byte code. + Sequence of operation names, indexable using the bytecode. .. data:: opmap - Dictionary mapping byte codes to operation names. + Dictionary mapping bytecodes to operation names. .. data:: cmp_op @@ -85,45 +85,45 @@ The :mod:`dis` module defines the following functions and constants: .. data:: hasconst - Sequence of byte codes that have a constant parameter. + Sequence of bytecodes that have a constant parameter. .. data:: hasfree - Sequence of byte codes that access a free variable. + Sequence of bytecodes that access a free variable. .. data:: hasname - Sequence of byte codes that access an attribute by name. + Sequence of bytecodes that access an attribute by name. .. data:: hasjrel - Sequence of byte codes that have a relative jump target. + Sequence of bytecodes that have a relative jump target. .. data:: hasjabs - Sequence of byte codes that have an absolute jump target. + Sequence of bytecodes that have an absolute jump target. .. data:: haslocal - Sequence of byte codes that access a local variable. + Sequence of bytecodes that access a local variable. .. data:: hascompare - Sequence of byte codes of Boolean operations. + Sequence of bytecodes of Boolean operations. .. _bytecodes: -Python Byte Code Instructions ------------------------------ +Python Bytecode Instructions +---------------------------- -The Python compiler currently generates the following byte code instructions. +The Python compiler currently generates the following bytecode instructions. .. opcode:: STOP_CODE () @@ -652,31 +652,31 @@ the more significant byte last. .. opcode:: JUMP_FORWARD (delta) - Increments byte code counter by *delta*. + Increments bytecode counter by *delta*. .. opcode:: JUMP_IF_TRUE (delta) - If TOS is true, increment the byte code counter by *delta*. TOS is left on the + If TOS is true, increment the bytecode counter by *delta*. TOS is left on the stack. .. opcode:: JUMP_IF_FALSE (delta) - If TOS is false, increment the byte code counter by *delta*. TOS is not + If TOS is false, increment the bytecode counter by *delta*. TOS is not changed. .. opcode:: JUMP_ABSOLUTE (target) - Set byte code counter to *target*. + Set bytecode counter to *target*. .. opcode:: FOR_ITER (delta) ``TOS`` is an iterator. Call its :meth:`next` method. If this yields a new value, push it on the stack (leaving the iterator below it). If the iterator - indicates it is exhausted ``TOS`` is popped, and the byte code counter is + indicates it is exhausted ``TOS`` is popped, and the bytecode counter is incremented by *delta*. .. % \begin{opcodedesc}{FOR_LOOP}{delta} diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index bfa9bc4..0d380ea 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -43,7 +43,7 @@ available. They are listed here in alphabetical order. top-level package (the name up till the first dot) is returned, *not* the module named by *name*. However, when a non-empty *fromlist* argument is given, the module named by *name* is returned. This is done for - compatibility with the bytecode generated for the different kinds of import + compatibility with the :term:`bytecode` generated for the different kinds of import statement; when using ``import spam.ham.eggs``, the top-level package :mod:`spam` must be placed in the importing namespace, but when using ``from spam.ham import eggs``, the ``spam.ham`` subpackage must be used to find the diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst index 04ea977..7e95eee 100644 --- a/Doc/library/inspect.rst +++ b/Doc/library/inspect.rst @@ -69,7 +69,7 @@ attributes: +-----------+-----------------+---------------------------+-------+ | | func_code | code object containing | | | | | compiled function | | -| | | bytecode | | +| | | :term:`bytecode` | | +-----------+-----------------+---------------------------+-------+ | | func_defaults | tuple of any default | | | | | values for arguments | | diff --git a/Doc/library/parser.rst b/Doc/library/parser.rst index c293005..b6249e9 100644 --- a/Doc/library/parser.rst +++ b/Doc/library/parser.rst @@ -319,7 +319,7 @@ Examples .. index:: builtin: compile The parser modules allows operations to be performed on the parse tree of Python -source code before the bytecode is generated, and provides for inspection of the +source code before the :term:`bytecode` is generated, and provides for inspection of the parse tree for information gathering purposes. Two examples are presented. The simple example demonstrates emulation of the :func:`compile` built-in function and the complex example shows the use of a parse tree for information discovery. |