diff options
author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2019-06-02 16:18:50 -0700 |
---|---|---|
committer | Ezio Melotti <ezio.melotti@gmail.com> | 2019-06-03 01:18:50 +0200 |
commit | 9390e98c3ed9eb9fa414030a2feec1926193af94 (patch) | |
tree | 8fda916eb936a73db2022a274b2b1fb85bdb0938 /Doc | |
parent | 6bd438e137a0618b8db949a4751304f541b6674d (diff) | |
download | cpython-git-9390e98c3ed9eb9fa414030a2feec1926193af94.tar.gz |
bpo-19184: Update the documentation of dis module. (GH-13652) (GH-13755)
* bpo-19184: Update the documentation of dis module
* Explain the behavior of the number of arguments of RAISE_VARGARGS
opcode.
* bpo-19184: Update blurb.
* bpo-19184: Fix typo in the dis Documentation.
* bpo-19184: Address review comments and improve the doc
* bpo-19184: Remove news file.
(cherry picked from commit e1179a5096fb12297ececd7a1c79969aa5747e28)
Co-authored-by: Michele Angrisano <michele.angrisano@gmail.com>
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/dis.rst | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index 6bbef3844d..b8cf4463d9 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -1059,9 +1059,13 @@ All of the following opcodes use their arguments. .. opcode:: RAISE_VARARGS (argc) - Raises an exception. *argc* indicates the number of arguments to the raise - statement, ranging from 0 to 3. The handler will find the traceback as TOS2, - the parameter as TOS1, and the exception as TOS. + Raises an exception using one of the 3 forms of the ``raise`` statement, + depending on the value of *argc*: + + * 0: ``raise`` (re-raise previous exception) + * 1: ``raise TOS`` (raise exception instance or type at ``TOS``) + * 2: ``raise TOS1 from TOS`` (raise exception instance or type at ``TOS1`` + with ``__cause__`` set to ``TOS``) .. opcode:: CALL_FUNCTION (argc) |