[Python-checkins] cpython (3.3): Closes #13026: fix documentation of MAKE_FUNCTION for 3.x.

[georg.brandl]

http://hg.python.org/cpython/rev/b9ab48c491d5
changeset:   86235:b9ab48c491d5
branch:      3.3
parent:      86232:6b0ca3963ff1
user:        Georg Brandl <georg at python.org>
date:        Sat Oct 12 18:41:18 2013 +0200
summary:
  Closes #13026: fix documentation of MAKE_FUNCTION for 3.x.

files:
  Doc/library/dis.rst |  15 +++++++++++----
  1 files changed, 11 insertions(+), 4 deletions(-)


diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -754,10 +754,17 @@
 
 .. opcode:: MAKE_FUNCTION (argc)
 
-   Pushes a new function object on the stack.  TOS is the
-   :term:`qualified name` of the function; TOS1 is the code associated with
-   the function.  The function object is defined to have *argc* default parameters,
-   which are found below TOS1.
+   Pushes a new function object on the stack.  From bottom to top, the consumed
+   stack must consist of
+
+   * ``argc & 0xFF`` default argument objects in positional order
+   * ``(argc >> 8) & 0xFF`` pairs of name and default argument, with the name
+     just below the object on the stack, for keyword-only parameters
+   * ``(argc >> 16) & 0x7FFF`` parameter annotation objects
+   * a tuple listing the parameter names for the annotations (only if there are
+     ony annotation objects)
+   * the code associated with the function (at TOS1)
+   * the :term:`qualified name` of the function (at TOS)
 
 
 .. opcode:: MAKE_CLOSURE (argc)

-- 
Repository URL: http://hg.python.org/cpython