[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