[Python-3000-checkins] r65161 - python/branches/py3k/Doc/library/dis.rst

[georg.brandl]

Author: georg.brandl
Date: Sun Jul 20 23:39:03 2008
New Revision: 65161

Log:
#3400: document new 3.0 opcodes.


Modified:
python/branches/py3k/Doc/library/dis.rst

Modified: python/branches/py3k/Doc/library/dis.rst
==============================================================================
--- python/branches/py3k/Doc/library/dis.rst (original)
+++ python/branches/py3k/Doc/library/dis.rst Sun Jul 20 23:39:03 2008
@@ -414,8 +414,8 @@

.. opcode:: LOAD_BUILD_CLASS ()

- Pushes builtins.__build_class__ onto the stack. It is later called by
- ```CALL_FUNCTION`` to construct a class.
+ Pushes :func:`builtins.__build_class__` onto the stack. It is later called
+ by :opcode:`CALL_FUNCTION` to construct a class.


.. opcode:: WITH_CLEANUP ()
@@ -440,6 +440,12 @@
.. XXX explain the WHY stuff!


+.. opcode:: STORE_LOCALS
+
+ Pops TOS from the stack and stores it as the current frame's ``f_locals``.
+ This is used in class construction.
+
+
All of the following opcodes expect arguments. An argument is two bytes, with
the more significant byte last.

@@ -462,6 +468,18 @@
right-to-left.


+.. opcode:: UNPACK_EX (counts)
+
+ Implements assignment with a starred target: Unpacks an iterable in TOS into
+ individual values, where the total number of values can be smaller than the
+ number of items in the iterable: one the new values will be a list of all
+ leftover items.
+
+ The low byte of *counts* is the number of values before the list value, the
+ high byte of *counts* the number of values after it. The resulting values
+ are put onto the stack right-to-left.
+
+
.. opcode:: DUP_TOPX (count)

Duplicate *count* items, keeping them in the same order. Due to implementation