[Python-checkins] [3.11] GH-97950: Use new-style index directive ('statement') (GH-104162) (#104163)
hugovk
webhook-mailer at python.org
Thu May 4 06:57:22 EDT 2023
https://github.com/python/cpython/commit/6a970ae66669153c62a128c0854ea364e29b69a0
commit: 6a970ae66669153c62a128c0854ea364e29b69a0
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: hugovk <hugovk at users.noreply.github.com>
date: 2023-05-04T13:57:14+03:00
summary:
[3.11] GH-97950: Use new-style index directive ('statement') (GH-104162) (#104163)
Co-authored-by: Adam Turner <9087854+AA-Turner at users.noreply.github.com>
files:
M Doc/library/exceptions.rst
M Doc/library/functions.rst
M Doc/library/site.rst
M Doc/library/stdtypes.rst
M Doc/reference/compound_stmts.rst
M Doc/reference/datamodel.rst
M Doc/reference/simple_stmts.rst
M Doc/tools/extensions/pyspecific.py
M Doc/tutorial/controlflow.rst
diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index aee1cb5cc6a4..4c84e5f85543 100644
--- a/Doc/library/exceptions.rst
+++ b/Doc/library/exceptions.rst
@@ -4,8 +4,8 @@ Built-in Exceptions
===================
.. index::
- statement: try
- statement: except
+ pair: statement; try
+ pair: statement; except
In Python, all exceptions must be instances of a class that derives from
:class:`BaseException`. In a :keyword:`try` statement with an :keyword:`except`
@@ -14,7 +14,7 @@ classes derived from that class (but not exception classes from which *it* is
derived). Two exception classes that are not related via subclassing are never
equivalent, even if they have the same name.
-.. index:: statement: raise
+.. index:: pair: statement; raise
The built-in exceptions listed below can be generated by the interpreter or
built-in functions. Except where mentioned, they have an "associated value"
@@ -175,7 +175,7 @@ The following exceptions are the exceptions that are usually raised.
.. exception:: AssertionError
- .. index:: statement: assert
+ .. index:: pair: statement; assert
Raised when an :keyword:`assert` statement fails.
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index c5bdfc21e183..1a7311911ba7 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1978,7 +1978,7 @@ are always available. They are listed here in alphabetical order.
.. function:: __import__(name, globals=None, locals=None, fromlist=(), level=0)
.. index::
- statement: import
+ pair: statement; import
pair: module; builtins
.. note::
diff --git a/Doc/library/site.rst b/Doc/library/site.rst
index 34b38f4d56f3..5b70dbced13e 100644
--- a/Doc/library/site.rst
+++ b/Doc/library/site.rst
@@ -51,7 +51,7 @@ searched for site-packages; otherwise they will.
.. index::
single: # (hash); comment
- statement: import
+ pair: statement; import
A path configuration file is a file whose name has the form :file:`{name}.pth`
and exists in one of the four directories mentioned above; its contents are
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 960959073c4b..d57581f1d535 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -32,8 +32,8 @@ Truth Value Testing
===================
.. index::
- statement: if
- statement: while
+ pair: statement; if
+ pair: statement; while
pair: truth; value
pair: Boolean; operations
single: false
@@ -1113,7 +1113,7 @@ accepts integers that meet the value restriction ``0 <= x <= 255``).
triple: operations on; list; type
pair: subscript; assignment
pair: slice; assignment
- statement: del
+ pair: statement; del
single: append() (sequence method)
single: clear() (sequence method)
single: copy() (sequence method)
@@ -4371,7 +4371,7 @@ Mapping Types --- :class:`dict`
pair: object; dictionary
triple: operations on; mapping; types
triple: operations on; dictionary; type
- statement: del
+ pair: statement; del
builtin: len
A :term:`mapping` object maps :term:`hashable` values to arbitrary objects.
diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst
index 4578e662ada6..cd448d213487 100644
--- a/Doc/reference/compound_stmts.rst
+++ b/Doc/reference/compound_stmts.rst
@@ -84,7 +84,7 @@ The :keyword:`!if` statement
============================
.. index::
- ! statement: if
+ ! pair: statement; if
pair: keyword; elif
pair: keyword; else
single: : (colon); compound statement
@@ -109,7 +109,7 @@ The :keyword:`!while` statement
===============================
.. index::
- ! statement: while
+ ! pair: statement; while
pair: keyword; else
pair: loop; statement
single: : (colon); compound statement
@@ -127,8 +127,8 @@ suite of the :keyword:`!else` clause, if present, is executed and the loop
terminates.
.. index::
- statement: break
- statement: continue
+ pair: statement; break
+ pair: statement; continue
A :keyword:`break` statement executed in the first suite terminates the loop
without executing the :keyword:`!else` clause's suite. A :keyword:`continue`
@@ -142,7 +142,7 @@ The :keyword:`!for` statement
=============================
.. index::
- ! statement: for
+ ! pair: statement; for
pair: keyword; in
pair: keyword; else
pair: target; list
@@ -167,8 +167,8 @@ the suite in the :keyword:`!else` clause,
if present, is executed, and the loop terminates.
.. index::
- statement: break
- statement: continue
+ pair: statement; break
+ pair: statement; continue
A :keyword:`break` statement executed in the first suite terminates the loop
without executing the :keyword:`!else` clause's suite. A :keyword:`continue`
@@ -205,7 +205,7 @@ The :keyword:`!try` statement
=============================
.. index::
- ! statement: try
+ ! pair: statement; try
pair: keyword; except
pair: keyword; finally
pair: keyword; else
@@ -390,9 +390,9 @@ cannot appear in an :keyword:`!except*` clause.
.. index::
pair: keyword; else
- statement: return
- statement: break
- statement: continue
+ pair: statement; return
+ pair: statement; break
+ pair: statement; continue
.. _except_else:
@@ -436,9 +436,9 @@ The exception information is not available to the program during execution of
the :keyword:`!finally` clause.
.. index::
- statement: return
- statement: break
- statement: continue
+ pair: statement; return
+ pair: statement; break
+ pair: statement; continue
When a :keyword:`return`, :keyword:`break` or :keyword:`continue` statement is
executed in the :keyword:`try` suite of a :keyword:`!try`...\ :keyword:`!finally`
@@ -470,7 +470,7 @@ The :keyword:`!with` statement
==============================
.. index::
- ! statement: with
+ ! pair: statement; with
pair: keyword; as
single: as; with statement
single: , (comma); with statement
@@ -587,7 +587,7 @@ The :keyword:`!match` statement
===============================
.. index::
- ! statement: match
+ ! pair: statement; match
! pair: keyword; case
! single: pattern matching
pair: keyword; if
@@ -1192,7 +1192,7 @@ Function definitions
====================
.. index::
- statement: def
+ pair: statement; def
pair: function; definition
pair: function; name
pair: name; binding
@@ -1366,7 +1366,7 @@ Class definitions
.. index::
pair: object; class
- statement: class
+ pair: statement; class
pair: class; definition
pair: class; name
pair: name; binding
@@ -1465,7 +1465,7 @@ Coroutines
.. versionadded:: 3.5
-.. index:: statement: async def
+.. index:: pair: statement; async def
.. _`async def`:
Coroutine function definition
@@ -1499,7 +1499,7 @@ An example of a coroutine function::
``await`` and ``async`` are now keywords; previously they were only
treated as such inside the body of a coroutine function.
-.. index:: statement: async for
+.. index:: pair: statement; async for
.. _`async for`:
The :keyword:`!async for` statement
@@ -1544,7 +1544,7 @@ It is a :exc:`SyntaxError` to use an ``async for`` statement outside the
body of a coroutine function.
-.. index:: statement: async with
+.. index:: pair: statement; async with
.. _`async with`:
The :keyword:`!async with` statement
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 3f3a37dacc15..73eb402b7166 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -727,7 +727,7 @@ Callable types
Modules
.. index::
- statement: import
+ pair: statement; import
pair: object; module
Modules are a basic organizational unit of Python code, and are created by
@@ -1150,7 +1150,7 @@ Internal types
single: tb_frame (traceback attribute)
single: tb_lineno (traceback attribute)
single: tb_lasti (traceback attribute)
- statement: try
+ pair: statement; try
Special read-only attributes:
:attr:`tb_frame` points to the execution frame of the current level;
@@ -1309,7 +1309,7 @@ Basic customization
.. index::
single: destructor
single: finalizer
- statement: del
+ pair: statement; del
Called when the instance is about to be destroyed. This is also called a
finalizer or (improperly) a destructor. If a base class has a
@@ -2791,7 +2791,7 @@ execution of the block of code. Context managers are normally invoked using the
used by directly invoking their methods.
.. index::
- statement: with
+ pair: statement; with
single: context manager
Typical uses of context managers include saving and restoring various kinds of
diff --git a/Doc/reference/simple_stmts.rst b/Doc/reference/simple_stmts.rst
index 7cf096019631..ca1aa744389b 100644
--- a/Doc/reference/simple_stmts.rst
+++ b/Doc/reference/simple_stmts.rst
@@ -376,7 +376,7 @@ The :keyword:`!assert` statement
================================
.. index::
- ! statement: assert
+ ! pair: statement; assert
pair: debugging; assertions
single: , (comma); expression list
@@ -419,7 +419,7 @@ The :keyword:`!pass` statement
==============================
.. index::
- statement: pass
+ pair: statement; pass
pair: null; operation
pair: null; operation
@@ -441,7 +441,7 @@ The :keyword:`!del` statement
=============================
.. index::
- ! statement: del
+ ! pair: statement; del
pair: deletion; target
triple: deletion; target; list
@@ -454,7 +454,7 @@ Rather than spelling it out in full details, here are some hints.
Deletion of a target list recursively deletes each target, from left to right.
.. index::
- statement: global
+ pair: statement; global
pair: unbinding; name
Deletion of a name removes the binding of that name from the local or global
@@ -480,7 +480,7 @@ The :keyword:`!return` statement
================================
.. index::
- ! statement: return
+ ! pair: statement; return
pair: function; definition
pair: class; definition
@@ -517,7 +517,7 @@ The :keyword:`!yield` statement
===============================
.. index::
- statement: yield
+ pair: statement; yield
single: generator; function
single: generator; iterator
single: function; generator
@@ -553,7 +553,7 @@ The :keyword:`!raise` statement
===============================
.. index::
- ! statement: raise
+ ! pair: statement; raise
single: exception
pair: raising; exception
single: __traceback__ (exception attribute)
@@ -667,9 +667,9 @@ The :keyword:`!break` statement
===============================
.. index::
- ! statement: break
- statement: for
- statement: while
+ ! pair: statement; break
+ pair: statement; for
+ pair: statement; while
pair: loop; statement
.. productionlist:: python-grammar
@@ -701,9 +701,9 @@ The :keyword:`!continue` statement
==================================
.. index::
- ! statement: continue
- statement: for
- statement: while
+ ! pair: statement; continue
+ pair: statement; for
+ pair: statement; while
pair: loop; statement
pair: keyword; finally
@@ -726,7 +726,7 @@ The :keyword:`!import` statement
================================
.. index::
- ! statement: import
+ ! pair: statement; import
single: module; importing
pair: name; binding
pair: keyword; from
@@ -942,7 +942,7 @@ The :keyword:`!global` statement
================================
.. index::
- ! statement: global
+ ! pair: statement; global
triple: global; name; binding
single: , (comma); identifier list
@@ -988,7 +988,7 @@ call. The same applies to the :func:`eval` and :func:`compile` functions.
The :keyword:`!nonlocal` statement
==================================
-.. index:: statement: nonlocal
+.. index:: pair: statement; nonlocal
single: , (comma); identifier list
.. productionlist:: python-grammar
diff --git a/Doc/tools/extensions/pyspecific.py b/Doc/tools/extensions/pyspecific.py
index 469b43254090..f9b2bfdc639a 100644
--- a/Doc/tools/extensions/pyspecific.py
+++ b/Doc/tools/extensions/pyspecific.py
@@ -699,7 +699,7 @@ def patch_pairindextypes(app) -> None:
pairindextypes.pop('operator', None)
pairindextypes.pop('object', None)
pairindextypes.pop('exception', None)
- # pairindextypes.pop('statement', None)
+ pairindextypes.pop('statement', None)
# pairindextypes.pop('builtin', None)
diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
index 52db51e84cd5..c9b3d982c31c 100644
--- a/Doc/tutorial/controlflow.rst
+++ b/Doc/tutorial/controlflow.rst
@@ -46,7 +46,7 @@ details see :ref:`tut-match`.
==========================
.. index::
- statement: for
+ pair: statement; for
The :keyword:`for` statement in Python differs a bit from what you may be used
to in C or Pascal. Rather than always iterating over an arithmetic progression
More information about the Python-checkins
mailing list