From: Éric Araujo Date: Thu, 1 Sep 2011 03:57:12 +0000 (+0200) Subject: Merge doc changes from 3.2. X-Git-Tag: v3.3.0a1~1581^2~5 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b8edbdf4b986048e48b689baf339023c38384ae7;p=thirdparty%2FPython%2Fcpython.git Merge doc changes from 3.2. rstlint complains about packaging docs but I’m working on those in another patch. --- b8edbdf4b986048e48b689baf339023c38384ae7 diff --cc Doc/faq/design.rst index b9faf576bfd4,02417b1e90f1..1f3135a9e557 --- a/Doc/faq/design.rst +++ b/Doc/faq/design.rst @@@ -667,7 -667,7 +667,7 @@@ construction of large programs Python 2.6 adds an :mod:`abc` module that lets you define Abstract Base Classes (ABCs). You can then use :func:`isinstance` and :func:`issubclass` to check whether an instance or a class implements a particular ABC. The - :mod:`collections` modules defines a set of useful ABCs such as -:mod:`collections` module defines a set of useful ABCs such as ++:mod:`collections.abc` module defines a set of useful ABCs such as :class:`Iterable`, :class:`Container`, and :class:`MutableMapping`. For Python, many of the advantages of interface specifications can be obtained diff --cc Doc/glossary.rst index c66aac162f09,3b211aedefb1..4f1795d91b74 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@@ -434,8 -434,8 +434,8 @@@ Glossar mapping A container object that supports arbitrary key lookups and implements the -- methods specified in the :class:`~collections.Mapping` or -- :class:`~collections.MutableMapping` ++ methods specified in the :class:`~collections.abc.Mapping` or ++ :class:`~collections.abc.MutableMapping` :ref:`abstract base classes `. Examples include :class:`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict` and :class:`collections.Counter`. diff --cc Doc/library/unittest.rst index 191d5b9fdd6e,6036f7de8821..7340588d1166 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@@ -723,9 -723,9 +723,9 @@@ Test case Here, we create two instances of :class:`WidgetTestCase`, each of which runs a single test. - .. versionchanged:: + .. versionchanged:: 3.2 - `TestCase` can be instantiated successfully without providing a method - name. This makes it easier to experiment with `TestCase` from the + :class:`TestCase` can be instantiated successfully without providing a method + name. This makes it easier to experiment with :class:`TestCase` from the interactive interpreter. *methodName* defaults to :meth:`runTest`.