[docs] [issue19184] dis module has incorrect docs for RAISE_VARARGS

Tyler B report at bugs.python.org
Tue Oct 15 12:37:13 CEST 2013


Tyler B added the comment:

One last edit:

Looked at the code and found differences between 3.4 and 2.7. 2.7 has 4 exceptions that can be raised while 3.4 has 3 exceptions. 

I propose including the full list of parameters but describing the exceptions in a way that's less specific about the TOS order to keep the documentation as simple as possible.   

# 2.7
"Raises an exception. argc indicates the number of parameters to the raise statement, ranging from 0 to 3. The parameters can consist of the traceback as TOS1, the value as TOS2, the exception as TOS3, and None as TOS4."

# 3.4  
"Raises an exception. argc indicates the number of parameters to the raise statement, ranging from 0 to 2. The parameters can consist of the cause as TOS1, the exception as TOS2, and None as TOS3."

How does this sound?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19184>
_______________________________________


More information about the docs mailing list