Skip to content

Commit 8cf7ebb

Browse files
[3.6] bpo-32565: Add missed versionadded directives for all new opcodes. (GH-5199). (GH-5471)
(cherry picked from commit 12e7cd8) Co-authored-by: Serhiy Storchaka <[email protected]>
1 parent 688b6de commit 8cf7ebb

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

Doc/library/dis.rst

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -318,12 +318,16 @@ The Python compiler currently generates the following bytecode instructions.
318318

319319
Duplicates the reference on top of the stack.
320320

321+
.. versionadded:: 3.2
322+
321323

322324
.. opcode:: DUP_TOP_TWO
323325

324326
Duplicates the two references on top of the stack, leaving them in the
325327
same order.
326328

329+
.. versionadded:: 3.2
330+
327331

328332
**Unary operations**
329333

@@ -534,29 +538,39 @@ the original TOS1.
534538
the CO_ITERABLE_COROUTINE flag, or resolves
535539
``o.__await__``.
536540

541+
.. versionadded:: 3.5
542+
537543

538544
.. opcode:: GET_AITER
539545

540546
Implements ``TOS = get_awaitable(TOS.__aiter__())``. See ``GET_AWAITABLE``
541547
for details about ``get_awaitable``
542548

549+
.. versionadded:: 3.5
550+
543551

544552
.. opcode:: GET_ANEXT
545553

546554
Implements ``PUSH(get_awaitable(TOS.__anext__()))``. See ``GET_AWAITABLE``
547555
for details about ``get_awaitable``
548556

557+
.. versionadded:: 3.5
558+
549559

550560
.. opcode:: BEFORE_ASYNC_WITH
551561

552562
Resolves ``__aenter__`` and ``__aexit__`` from the object on top of the
553563
stack. Pushes ``__aexit__`` and result of ``__aenter__()`` to the stack.
554564

565+
.. versionadded:: 3.5
566+
555567

556568
.. opcode:: SETUP_ASYNC_WITH
557569

558570
Creates a new frame object.
559571

572+
.. versionadded:: 3.5
573+
560574

561575

562576
**Miscellaneous opcodes**
@@ -594,6 +608,8 @@ the original TOS1.
594608
Calls ``dict.setitem(TOS1[-i], TOS, TOS1)``. Used to implement dict
595609
comprehensions.
596610

611+
.. versionadded:: 3.1
612+
597613
For all of the :opcode:`SET_ADD`, :opcode:`LIST_APPEND` and :opcode:`MAP_ADD`
598614
instructions, while the added value or key/value pair is popped off, the
599615
container object remains on the stack so that it is available for further
@@ -616,6 +632,7 @@ iterations of the loop.
616632

617633
.. versionadded:: 3.3
618634

635+
619636
.. opcode:: SETUP_ANNOTATIONS
620637

621638
Checks whether ``__annotations__`` is defined in ``locals()``, if not it is
@@ -625,6 +642,7 @@ iterations of the loop.
625642

626643
.. versionadded:: 3.6
627644

645+
628646
.. opcode:: IMPORT_STAR
629647

630648
Loads all symbols not starting with ``'_'`` directly from the module TOS to
@@ -670,6 +688,8 @@ iterations of the loop.
670688
store it in (a) variable(s) (:opcode:`STORE_FAST`, :opcode:`STORE_NAME`, or
671689
:opcode:`UNPACK_SEQUENCE`).
672690

691+
.. versionadded:: 3.2
692+
673693

674694
.. opcode:: WITH_CLEANUP_START
675695

@@ -900,23 +920,31 @@ All of the following opcodes use their arguments.
900920

901921
If TOS is true, sets the bytecode counter to *target*. TOS is popped.
902922

923+
.. versionadded:: 3.1
924+
903925

904926
.. opcode:: POP_JUMP_IF_FALSE (target)
905927

906928
If TOS is false, sets the bytecode counter to *target*. TOS is popped.
907929

930+
.. versionadded:: 3.1
931+
908932

909933
.. opcode:: JUMP_IF_TRUE_OR_POP (target)
910934

911935
If TOS is true, sets the bytecode counter to *target* and leaves TOS on the
912936
stack. Otherwise (TOS is false), TOS is popped.
913937

938+
.. versionadded:: 3.1
939+
914940

915941
.. opcode:: JUMP_IF_FALSE_OR_POP (target)
916942

917943
If TOS is false, sets the bytecode counter to *target* and leaves TOS on the
918944
stack. Otherwise (TOS is true), TOS is popped.
919945

946+
.. versionadded:: 3.1
947+
920948

921949
.. opcode:: JUMP_ABSOLUTE (target)
922950

@@ -996,6 +1024,8 @@ All of the following opcodes use their arguments.
9961024
consulting the cell. This is used for loading free variables in class
9971025
bodies.
9981026

1027+
.. versionadded:: 3.4
1028+
9991029

10001030
.. opcode:: STORE_DEREF (i)
10011031

@@ -1008,6 +1038,8 @@ All of the following opcodes use their arguments.
10081038
Empties the cell contained in slot *i* of the cell and free variable storage.
10091039
Used by the :keyword:`del` statement.
10101040

1041+
.. versionadded:: 3.2
1042+
10111043

10121044
.. opcode:: RAISE_VARARGS (argc)
10131045

0 commit comments

Comments
 (0)