summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2007-10-21 10:24:20 (GMT)
committerGeorg Brandl <georg@python.org>2007-10-21 10:24:20 (GMT)
commit63fa16832617bfad010e3e70e7f10f713afd7593 (patch)
tree2f24ea291751a34d0b556833b5a1c3c353fb23a8 /Doc/library
parentfa6179701c0dd7f2ecc21fe0ff6204a4e865094f (diff)
downloadcpython-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.rst4
-rw-r--r--Doc/library/dis.rst46
-rw-r--r--Doc/library/functions.rst2
-rw-r--r--Doc/library/inspect.rst2
-rw-r--r--Doc/library/parser.rst2
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.