From ad23c1e635c5aeae0b00a7e8e442253d29143ce6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Fri, 15 Jun 2018 11:43:39 -0300 Subject: [PATCH 1/2] bpo-33869: Add set, frozen set, and tuple entries to Glossary --- Doc/glossary.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 988842aefc0d67..e95e99bbe8d15a 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -378,6 +378,11 @@ Glossary division. Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75`` rounded *downward*. See :pep:`238`. + frozen set + An :term:`immutable` built-in :term:`set` type. + + See :ref:`types-set`, and :pep:`218`, which introduced frozen sets. + function A series of statements which returns some value to a caller. It can also be passed zero or more :term:`arguments ` which may be used in @@ -644,6 +649,8 @@ Glossary to an array in other languages than to a linked list since access to elements are O(1). + See :ref:`typesseq`. + list comprehension A compact way to process all or part of the elements in a sequence and return a list with the results. ``result = ['{:#04x}'.format(x) for x in @@ -988,6 +995,16 @@ Glossary interface can be registered explicitly using :func:`~abc.register`. + set + An unordered collection of distinct :term:`hashable` objects that eases + duplicate removal and computation of mathematical operations such as + intersection and difference. + + Python provides two built-in set types: set (a :term:`mutable` type), and + frozen set (an :term:`immutable` type). + + See :ref:`types-set`, and :pep:`218`, which introduced sets. + single dispatch A form of :term:`generic function` dispatch where the implementation is chosen based on the type of a single argument. @@ -1040,6 +1057,11 @@ Glossary use of the continuation character, making them especially useful when writing docstrings. + tuple + An :term:`immutable` built-in :term:`sequence`. + + See :ref:`typesseq`. + type The type of a Python object determines what kind of object it is; every object has a type. An object's type is accessible as its From c4f8cb245a9de3bcee361ae1ed60d0d459ad66d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sat, 16 Jun 2018 21:58:59 -0300 Subject: [PATCH 2/2] Remove type definitions according to Raymond's comments --- Doc/glossary.rst | 20 -------------------- 1 file changed, 20 deletions(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index e95e99bbe8d15a..2a3a7d60c56239 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -378,11 +378,6 @@ Glossary division. Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75`` rounded *downward*. See :pep:`238`. - frozen set - An :term:`immutable` built-in :term:`set` type. - - See :ref:`types-set`, and :pep:`218`, which introduced frozen sets. - function A series of statements which returns some value to a caller. It can also be passed zero or more :term:`arguments ` which may be used in @@ -995,16 +990,6 @@ Glossary interface can be registered explicitly using :func:`~abc.register`. - set - An unordered collection of distinct :term:`hashable` objects that eases - duplicate removal and computation of mathematical operations such as - intersection and difference. - - Python provides two built-in set types: set (a :term:`mutable` type), and - frozen set (an :term:`immutable` type). - - See :ref:`types-set`, and :pep:`218`, which introduced sets. - single dispatch A form of :term:`generic function` dispatch where the implementation is chosen based on the type of a single argument. @@ -1057,11 +1042,6 @@ Glossary use of the continuation character, making them especially useful when writing docstrings. - tuple - An :term:`immutable` built-in :term:`sequence`. - - See :ref:`typesseq`. - type The type of a Python object determines what kind of object it is; every object has a type. An object's type is accessible as its