[Python-checkins] bpo-32625: Updated documentation for EXTENDED_ARG. (GH-13985)

Tue Jun 11 23:54:01 EDT 2019

https://github.com/python/cpython/commit/811f84d55d156e3d05889806d00a8c028d304089
commit: 811f84d55d156e3d05889806d00a8c028d304089
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019年06月11日T20:53:58-07:00
summary:
bpo-32625: Updated documentation for EXTENDED_ARG. (GH-13985)
Python 3.6 changed the size of bytecode instruction, while the documentation for `EXTENDED_ARG` was not updated accordingly.
(cherry picked from commit 405f648db7c44b07348582b5101d4716e0ce5ac3)
Co-authored-by: Yao Zuo <laike9m at users.noreply.github.com>
files:
M Doc/library/dis.rst

diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 2a3ffb5e8271..5b79be626626 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -1219,10 +1219,10 @@ All of the following opcodes use their arguments.
 
 .. opcode:: EXTENDED_ARG (ext)
 
- Prefixes any opcode which has an argument too big to fit into the default two
- bytes. *ext* holds two additional bytes which, taken together with the
- subsequent opcode's argument, comprise a four-byte argument, *ext* being the
- two most-significant bytes.
+ Prefixes any opcode which has an argument too big to fit into the default one
+ byte. *ext* holds an additional byte which act as higher bits in the argument.
+ For each opcode, at most three prefixal ``EXTENDED_ARG`` are allowed, forming
+ an argument from two-byte to four-byte.
 
 
 .. opcode:: FORMAT_VALUE (flags)
