Skip to content

Commit 9be8a6b

Browse files
committed
Response to comments, second round
1 parent a53672b commit 9be8a6b

File tree

1 file changed

+13
-10
lines changed

1 file changed

+13
-10
lines changed

Doc/library/dis.rst

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -772,13 +772,13 @@ All of the following opcodes use their arguments.
772772

773773
.. opcode:: BUILD_MAP (count)
774774

775-
Pushes a new dictionary object onto the stack. Pops ``2 * count`` items
776-
so that the dictionary holds ``count`` entries:
775+
Pushes a new dictionary object onto the stack. Pops *2 \* count* items
776+
so that the dictionary holds *count* entries:
777777
``{..., TOS3: TOS2, TOS1: TOS}``.
778778

779779
.. versionchanged:: 3.5
780780
The dictionary is created from stack items instead of creating an
781-
empty dictionary pre-sized to hold ``count`` items.
781+
empty dictionary pre-sized to hold *count* items.
782782

783783

784784
.. opcode:: BUILD_CONST_KEY_MAP (count)
@@ -800,7 +800,7 @@ All of the following opcodes use their arguments.
800800

801801
.. opcode:: BUILD_TUPLE_UNPACK (count)
802802

803-
Pops ``count`` iterables from the stack, joins them in a single tuple,
803+
Pops *count* iterables from the stack, joins them in a single tuple,
804804
and pushes the result. This bytecode is used for implementing iterable
805805
unpacking in tuple displays ``(*x, *y, *z)``.
806806

@@ -810,23 +810,26 @@ All of the following opcodes use their arguments.
810810
.. opcode:: BUILD_LIST_UNPACK (count)
811811

812812
This is similar to :opcode:`BUILD_TUPLE_UNPACK`, but pushes a list
813-
instead of tuple.
813+
instead of tuple. This bytecode is used for implementing iterable
814+
unpacking in list displays ``[*x, *y, *z]``.
814815

815816
.. versionadded:: 3.5
816817

817818

818819
.. opcode:: BUILD_SET_UNPACK (count)
819820

820821
This is similar to :opcode:`BUILD_TUPLE_UNPACK`, but pushes a set
821-
instead of tuple.
822+
instead of tuple. This bytecode is used for implementing iterable
823+
unpacking in set displays ``{*x, *y, *z}``.
822824

823825
.. versionadded:: 3.5
824826

825827

826828
.. opcode:: BUILD_MAP_UNPACK (count)
827829

828-
Pops ``count`` mappings from the stack, joins them in a single dictionary,
829-
and pushes the result.
830+
Pops *count* mappings from the stack, merges them in a single dictionary,
831+
and pushes the result. This bytecode is used for implementing iterable
832+
unpacking in dictionary displays ``{**x, **y, **z}``.
830833

831834
.. versionadded:: 3.5
832835

@@ -835,8 +838,8 @@ All of the following opcodes use their arguments.
835838

836839
This is similar to :opcode:`BUILD_MAP_UNPACK`,
837840
but is used for ``f(**x, **y, **z)`` call syntax. The lowest byte of
838-
``oparg`` is the count of mappings, the relative position of the
839-
corresponding callable ``f`` is encoded in the second byte of ``oparg``.
841+
*oparg* is the count of mappings, the relative position of the
842+
corresponding callable ``f`` is encoded in the second byte of *oparg*.
840843

841844
.. versionadded:: 3.5
842845

0 commit comments

Comments
 (0)