Bytecode changes in 3.14 are not documented in `dis` module docs

[Techcable]

Documentation

The module documentation for dis normally contains documentation for all non-specialized bytecode instructions.

However, many of the new bytecode instructions added in 3.14 (BUILD_INTERPOLATION, NOT_TAKEN, etc) are missing from the 3.14 module docs. Some changes to existing instructions like CALL_FUNCTION_EX are also undocumented.

• BUILD_TEMPLATE
• BUILD_INTERPOLATION
• NOT_TAKEN
• POP_ITER
• CALL_FUNCTION_EX (changed)
• Remove BINARY_SUBSCR

Based on pycore_magic_number.h, it appears all changes after Python 3.14a2 with magic number 3609 are undocumented. Changes before this, like the addition of LOAD_SMALL_INT are correctly documented.

Linked PRs

• gh-135447: Update dis.rst to reflect 3.14 bytecode instructions #135478
• gh-135447: Document NOT_TAKEN & POP_ITER bytecode instructions #135803
• [3.14] gh-135447: Document the NOT_TAKEN & POP_ITER bytecode instructions (GH-135803) #139399

[esc]

Can you add POP_ITER:

#128445 (comment)

it seems to be missing too.

[esc]

The description is not accurate, LOAD_SMALL_INT is documented:

[esc]

Anyone know how CALL_FUNCTION_EX was changed, flags could be None?

[Techcable]

Can you add POP_ITER:

Added

The description is not accurate, LOAD_SMALL_INT is documented:

You are correct. It appears that some of the older 3.14 bytecodes are documented. Based on pycore_magic_number.h, LOAD_SMALL_INT was added in Python 3.14a2 with magic number 3609. Changes before this are documented, and changes to the bytecode after this are undocumented. I have updated the main comment with this fact and other bytecode changes.

Anyone know how CALL_FUNCTION_EX was changed, flags could be None?
Based on pycore_magic_number.h, I think the flag for has_kwargs has been dropped.

[esc]

Can you add POP_ITER:

Added

Great!

The description is not accurate, LOAD_SMALL_INT is documented:

You are correct. It appears that some of the older 3.14 bytecodes are documented. Based on pycore_magic_number.h, LOAD_SMALL_INT was added in Python 3.14a2 with magic number 3609. Changes before this are documented, and changes to the bytecode after this are undocumented. I have updated the main comment with this fact and other bytecode changes.

Great!

Anyone know how CALL_FUNCTION_EX was changed, flags could be None?
Based on pycore_magic_number.h, I think the flag for has_kwargs has been dropped.

Yeah, that sounds correctish. I also found:

https://github.com/python/cpython/pull/129226/files

and that states:

    Python 3.14a5 3615 (CALL_FUNCTION_EX always take a kwargs argument)

[esc]

Can you add POP_ITER:

Added

Great!

FWIW: this is the PR that introduced POP_ITER: #128445