Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

gh-101100: Resolve reference warnings in reference/ #138418

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AA-Turner merged 5 commits into python:main from AA-Turner:docs/refwarn/datamodel
Sep 8, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions Doc/reference/compound_stmts.rst
View file Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -610,9 +610,9 @@ The match statement is used for pattern matching. Syntax:

.. productionlist:: python-grammar
match_stmt: 'match' `subject_expr` ":" NEWLINE INDENT `case_block`+ DEDENT
subject_expr: `star_named_expression` "," `star_named_expressions`?
: | `named_expression`
case_block: 'case' `patterns` [`guard`] ":" `block`
subject_expr: `!star_named_expression` "," `!star_named_expressions`?
: | `!named_expression`
case_block: 'case' `patterns` [`guard`] ":" `!block`

.. note::
This section uses single quotes to denote
Expand Down Expand Up @@ -701,7 +701,7 @@ Guards
.. index:: ! guard

.. productionlist:: python-grammar
guard: "if" `named_expression`
guard: "if" `!named_expression`

A ``guard`` (which is part of the ``case``) must succeed for code inside
the ``case`` block to execute. It takes the form: :keyword:`if` followed by an
Expand Down Expand Up @@ -1015,8 +1015,8 @@ subject value:
items, as for a fixed-length sequence.

.. note:: The length of the subject sequence is obtained via
:func:`len` (i.e. via the :meth:`__len__` protocol). This length may be
cached by the interpreter in a similar manner as
:func:`len` (i.e. via the :meth:`~object.__len__` protocol).
This length may be cached by the interpreter in a similar manner as
:ref:`value patterns <value-patterns>`.


Expand Down
14 changes: 7 additions & 7 deletions Doc/reference/datamodel.rst
View file Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -453,7 +453,7 @@ Sets

These represent a mutable set. They are created by the built-in :func:`set`
constructor and can be modified afterwards by several methods, such as
:meth:`~set.add`.
:meth:`add <frozenset.add>`.


Frozen sets
Expand Down Expand Up @@ -1272,7 +1272,7 @@ Special attributes
* - .. attribute:: type.__firstlineno__
- The line number of the first line of the class definition,
including decorators.
Setting the :attr:`__module__` attribute removes the
Setting the :attr:`~type.__module__` attribute removes the
:attr:`!__firstlineno__` item from the type's dictionary.

.. versionadded:: 3.13
Expand Down Expand Up @@ -1903,9 +1903,9 @@ falling back to :meth:`~object.__getitem__`). [#]_
When implementing a class that emulates any built-in type, it is important that
the emulation only be implemented to the degree that it makes sense for the
object being modelled. For example, some sequences may work well with retrieval
of individual elements, but extracting a slice may not make sense. (One example
of this is the :class:`~xml.dom.NodeList` interface in the W3C's Document
Object Model.)
of individual elements, but extracting a slice may not make sense.
(One example of this is the :ref:`NodeList <dom-nodelist-objects>` interface
in the W3C's Document Object Model.)


.. _customization:
Expand Down Expand Up @@ -2697,7 +2697,7 @@ class defining the method.
.. versionadded:: 3.6


When a class is created, :meth:`type.__new__` scans the class variables
When a class is created, :meth:`!type.__new__` scans the class variables
and makes callbacks to those with a :meth:`~object.__set_name__` hook.

.. method:: object.__set_name__(self, owner, name)
Expand Down Expand Up @@ -3145,7 +3145,7 @@ objects. The :mod:`collections.abc` module provides a
Mutable sequences should provide methods :meth:`~sequence.append`,
:meth:`~sequence.count`, :meth:`~sequence.index`, :meth:`~sequence.extend`,
:meth:`~sequence.insert`, :meth:`~sequence.pop`, :meth:`~sequence.remove`,
:meth:`~sequence.reverse` and :meth:`~sequence.sort`,
:meth:`~sequence.reverse` and :meth:`!sort`,
like Python standard :class:`list` objects.
Finally, sequence types should implement addition (meaning concatenation) and
multiplication (meaning repetition) by defining the methods
Expand Down
2 changes: 0 additions & 2 deletions Doc/tools/.nitignore
View file Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,8 +54,6 @@ Doc/library/xml.sax.rst
Doc/library/xmlrpc.client.rst
Doc/library/xmlrpc.server.rst
Doc/library/zlib.rst
Doc/reference/compound_stmts.rst
Doc/reference/datamodel.rst
Doc/whatsnew/2.4.rst
Doc/whatsnew/2.5.rst
Doc/whatsnew/2.6.rst
Loading

AltStyle によって変換されたページ (->オリジナル) /