summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorWei-Hsiang (Matt) Wang <mattwang44@gmail.com>2024-08-30 11:34:09 (GMT)
committerGitHub <noreply@github.com>2024-08-30 11:34:09 (GMT)
commit103a0470e31d80d56097f57a27d97d7d2d3c9fbb (patch)
tree52f32100a42617bf120a8bdb8d3aa193dc35ae8d /Doc
parent8aaf7525ab839c32966ee862363ad2543a721306 (diff)
downloadcpython-103a0470e31d80d56097f57a27d97d7d2d3c9fbb.zip
cpython-103a0470e31d80d56097f57a27d97d7d2d3c9fbb.tar.gz
cpython-103a0470e31d80d56097f57a27d97d7d2d3c9fbb.tar.bz2
gh-123492: Remove unnecessary `:func:` parentheses (#123493)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/c-api/exceptions.rst2
-rw-r--r--Doc/c-api/import.rst2
-rw-r--r--Doc/deprecations/pending-removal-in-3.13.rst2
-rw-r--r--Doc/deprecations/pending-removal-in-3.15.rst4
-rw-r--r--Doc/howto/descriptor.rst2
-rw-r--r--Doc/howto/enum.rst4
-rw-r--r--Doc/howto/instrumentation.rst2
-rw-r--r--Doc/library/ast.rst2
-rw-r--r--Doc/library/asyncio-runner.rst2
-rw-r--r--Doc/library/compileall.rst2
-rw-r--r--Doc/library/contextvars.rst4
-rw-r--r--Doc/library/enum.rst2
-rw-r--r--Doc/library/functions.rst4
-rw-r--r--Doc/library/functools.rst2
-rw-r--r--Doc/library/getpass.rst2
-rw-r--r--Doc/library/inspect.rst12
-rw-r--r--Doc/library/io.rst6
-rw-r--r--Doc/library/ipaddress.rst2
-rw-r--r--Doc/library/os.rst12
-rw-r--r--Doc/library/pdb.rst2
-rw-r--r--Doc/library/platform.rst4
-rw-r--r--Doc/library/signal.rst2
-rw-r--r--Doc/library/stdtypes.rst2
-rw-r--r--Doc/library/subprocess.rst6
-rw-r--r--Doc/library/sys.rst4
-rw-r--r--Doc/library/sysconfig.rst2
-rw-r--r--Doc/library/tarfile.rst2
-rw-r--r--Doc/library/test.rst2
-rw-r--r--Doc/library/time.rst4
-rw-r--r--Doc/library/token.rst2
-rw-r--r--Doc/library/unittest.rst2
-rw-r--r--Doc/library/zipapp.rst2
-rw-r--r--Doc/reference/datamodel.rst2
-rw-r--r--Doc/tutorial/floatingpoint.rst2
-rw-r--r--Doc/using/cmdline.rst2
-rw-r--r--Doc/using/ios.rst4
-rw-r--r--Doc/whatsnew/3.10.rst8
-rw-r--r--Doc/whatsnew/3.12.rst4
-rw-r--r--Doc/whatsnew/3.14.rst2
-rw-r--r--Doc/whatsnew/3.2.rst2
-rw-r--r--Doc/whatsnew/3.3.rst4
-rw-r--r--Doc/whatsnew/3.4.rst2
-rw-r--r--Doc/whatsnew/3.6.rst8
-rw-r--r--Doc/whatsnew/3.7.rst2
-rw-r--r--Doc/whatsnew/3.8.rst16
-rw-r--r--Doc/whatsnew/3.9.rst2
46 files changed, 83 insertions, 83 deletions
diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index 499bfb4..372fc1d 100644
--- a/Doc/c-api/exceptions.rst
+++ b/Doc/c-api/exceptions.rst
@@ -34,7 +34,7 @@ propagated, additional calls into the Python/C API may not behave as intended
and may fail in mysterious ways.
.. note::
- The error indicator is **not** the result of :func:`sys.exc_info()`.
+ The error indicator is **not** the result of :func:`sys.exc_info`.
The former corresponds to an exception that is not yet caught (and is
therefore still propagating), while the latter returns an exception after
it is caught (and has therefore stopped propagating).
diff --git a/Doc/c-api/import.rst b/Doc/c-api/import.rst
index 1054b38..8108a50 100644
--- a/Doc/c-api/import.rst
+++ b/Doc/c-api/import.rst
@@ -190,7 +190,7 @@ Importing Modules
.. versionadded:: 3.2
.. versionchanged:: 3.3
- Uses :func:`!imp.source_from_cache()` in calculating the source path if
+ Uses :func:`!imp.source_from_cache` in calculating the source path if
only the bytecode path is provided.
.. versionchanged:: 3.12
No longer uses the removed :mod:`!imp` module.
diff --git a/Doc/deprecations/pending-removal-in-3.13.rst b/Doc/deprecations/pending-removal-in-3.13.rst
index 03c785b..8979049 100644
--- a/Doc/deprecations/pending-removal-in-3.13.rst
+++ b/Doc/deprecations/pending-removal-in-3.13.rst
@@ -48,5 +48,5 @@ APIs:
* ``read_binary()``
* ``read_text()``
- Use :func:`importlib.resources.files()` instead. Refer to `importlib-resources: Migrating from Legacy
+ Use :func:`importlib.resources.files` instead. Refer to `importlib-resources: Migrating from Legacy
<https://importlib-resources.readthedocs.io/en/latest/using.html#migrating-from-legacy>`_ (:gh:`106531`)
diff --git a/Doc/deprecations/pending-removal-in-3.15.rst b/Doc/deprecations/pending-removal-in-3.15.rst
index 85eb634..5374e87 100644
--- a/Doc/deprecations/pending-removal-in-3.15.rst
+++ b/Doc/deprecations/pending-removal-in-3.15.rst
@@ -9,8 +9,8 @@ Pending Removal in Python 3.15
* :class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python 3.11
and originally planned for removal in Python 3.13 (:gh:`90817`),
but removal has been postponed to Python 3.15.
- Use :func:`locale.setlocale()`, :func:`locale.getencoding()` and
- :func:`locale.getlocale()` instead.
+ Use :func:`locale.setlocale`, :func:`locale.getencoding` and
+ :func:`locale.getlocale` instead.
(Contributed by Hugo van Kemenade in :gh:`111187`.)
* :mod:`pathlib`:
diff --git a/Doc/howto/descriptor.rst b/Doc/howto/descriptor.rst
index 67e981f..7fb54d6 100644
--- a/Doc/howto/descriptor.rst
+++ b/Doc/howto/descriptor.rst
@@ -513,7 +513,7 @@ were defined.
Descriptors are a powerful, general purpose protocol. They are the mechanism
behind properties, methods, static methods, class methods, and
-:func:`super()`. They are used throughout Python itself. Descriptors
+:func:`super`. They are used throughout Python itself. Descriptors
simplify the underlying C code and offer a flexible set of new tools for
everyday Python programs.
diff --git a/Doc/howto/enum.rst b/Doc/howto/enum.rst
index 18e13fc..f406873 100644
--- a/Doc/howto/enum.rst
+++ b/Doc/howto/enum.rst
@@ -9,7 +9,7 @@ Enum HOWTO
.. currentmodule:: enum
An :class:`Enum` is a set of symbolic names bound to unique values. They are
-similar to global variables, but they offer a more useful :func:`repr()`,
+similar to global variables, but they offer a more useful :func:`repr`,
grouping, type-safety, and a few other features.
They are most useful when you have a variable that can take one of a limited
@@ -167,7 +167,7 @@ And a function to display the chores for a given day::
answer SO questions
In cases where the actual values of the members do not matter, you can save
-yourself some work and use :func:`auto()` for the values::
+yourself some work and use :func:`auto` for the values::
>>> from enum import auto
>>> class Weekday(Flag):
diff --git a/Doc/howto/instrumentation.rst b/Doc/howto/instrumentation.rst
index 9c99fce..6e03ef2 100644
--- a/Doc/howto/instrumentation.rst
+++ b/Doc/howto/instrumentation.rst
@@ -307,7 +307,7 @@ Available static markers
.. object:: gc__start(int generation)
Fires when the Python interpreter starts a garbage collection cycle.
- ``arg0`` is the generation to scan, like :func:`gc.collect()`.
+ ``arg0`` is the generation to scan, like :func:`gc.collect`.
.. object:: gc__done(long collected)
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index dd5dd5c..8c80a79 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -2134,7 +2134,7 @@ and classes for traversing abstract syntax trees:
If ``type_comments=True`` is given, the parser is modified to check
and return type comments as specified by :pep:`484` and :pep:`526`.
This is equivalent to adding :data:`ast.PyCF_TYPE_COMMENTS` to the
- flags passed to :func:`compile()`. This will report syntax errors
+ flags passed to :func:`compile`. This will report syntax errors
for misplaced type comments. Without this flag, type comments will
be ignored, and the ``type_comment`` field on selected AST nodes
will always be ``None``. In addition, the locations of ``# type:
diff --git a/Doc/library/asyncio-runner.rst b/Doc/library/asyncio-runner.rst
index ec170df..8312e55 100644
--- a/Doc/library/asyncio-runner.rst
+++ b/Doc/library/asyncio-runner.rst
@@ -91,7 +91,7 @@ Runner context manager
current one. By default :func:`asyncio.new_event_loop` is used and set as
current event loop with :func:`asyncio.set_event_loop` if *loop_factory* is ``None``.
- Basically, :func:`asyncio.run()` example can be rewritten with the runner usage::
+ Basically, :func:`asyncio.run` example can be rewritten with the runner usage::
async def main():
await asyncio.sleep(1)
diff --git a/Doc/library/compileall.rst b/Doc/library/compileall.rst
index d9c0cb6..c422884 100644
--- a/Doc/library/compileall.rst
+++ b/Doc/library/compileall.rst
@@ -90,7 +90,7 @@ compile Python sources.
.. option:: -j N
Use *N* workers to compile the files within the given directory.
- If ``0`` is used, then the result of :func:`os.process_cpu_count()`
+ If ``0`` is used, then the result of :func:`os.process_cpu_count`
will be used.
.. option:: --invalidation-mode [timestamp|checked-hash|unchecked-hash]
diff --git a/Doc/library/contextvars.rst b/Doc/library/contextvars.rst
index 8ae386b..b2261ea 100644
--- a/Doc/library/contextvars.rst
+++ b/Doc/library/contextvars.rst
@@ -15,7 +15,7 @@ function and the :class:`~contextvars.Context` class should be used to
manage the current context in asynchronous frameworks.
Context managers that have state should use Context Variables
-instead of :func:`threading.local()` to prevent their state from
+instead of :func:`threading.local` to prevent their state from
bleeding to other code unexpectedly, when used in concurrent code.
See also :pep:`567` for additional details.
@@ -146,7 +146,7 @@ Manual Context Management
Every thread will have a different top-level :class:`~contextvars.Context`
object. This means that a :class:`ContextVar` object behaves in a similar
- fashion to :func:`threading.local()` when values are assigned in different
+ fashion to :func:`threading.local` when values are assigned in different
threads.
Context implements the :class:`collections.abc.Mapping` interface.
diff --git a/Doc/library/enum.rst b/Doc/library/enum.rst
index 0a42461..242b243 100644
--- a/Doc/library/enum.rst
+++ b/Doc/library/enum.rst
@@ -663,7 +663,7 @@ Data Types
* the result is a valid *IntFlag*: an *IntFlag* is returned
* the result is not a valid *IntFlag*: the result depends on the :class:`FlagBoundary` setting
- The :func:`repr()` of unnamed zero-valued flags has changed. It is now:
+ The :func:`repr` of unnamed zero-valued flags has changed. It is now:
>>> Color(0)
<Color: 0>
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 8b51b56..2c55f2b 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -161,7 +161,7 @@ are always available. They are listed here in alphabetical order.
This function drops you into the debugger at the call site. Specifically,
it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight
through. By default, ``sys.breakpointhook()`` calls
- :func:`pdb.set_trace()` expecting no arguments. In this case, it is
+ :func:`pdb.set_trace` expecting no arguments. In this case, it is
purely a convenience function so you don't have to explicitly import
:mod:`pdb` or type as much code to enter the debugger. However,
:func:`sys.breakpointhook` can be set to some other function and
@@ -1336,7 +1336,7 @@ are always available. They are listed here in alphabetical order.
(which on *some* Unix systems, means that *all* writes append to the end of
the file regardless of the current seek position). In text mode, if
*encoding* is not specified the encoding used is platform-dependent:
- :func:`locale.getencoding()` is called to get the current locale encoding.
+ :func:`locale.getencoding` is called to get the current locale encoding.
(For reading and writing raw bytes use binary mode and leave
*encoding* unspecified.) The available modes are:
diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst
index 9d5c728..5f3607b 100644
--- a/Doc/library/functools.rst
+++ b/Doc/library/functools.rst
@@ -34,7 +34,7 @@ The :mod:`functools` module defines the following functions:
Returns the same as ``lru_cache(maxsize=None)``, creating a thin
wrapper around a dictionary lookup for the function arguments. Because it
never needs to evict old values, this is smaller and faster than
- :func:`lru_cache()` with a size limit.
+ :func:`lru_cache` with a size limit.
For example::
diff --git a/Doc/library/getpass.rst b/Doc/library/getpass.rst
index 9d67250..3b5296f 100644
--- a/Doc/library/getpass.rst
+++ b/Doc/library/getpass.rst
@@ -49,7 +49,7 @@ The :mod:`getpass` module provides two functions:
systems which support the :mod:`pwd` module, otherwise, an :exc:`OSError`
is raised.
- In general, this function should be preferred over :func:`os.getlogin()`.
+ In general, this function should be preferred over :func:`os.getlogin`.
.. versionchanged:: 3.13
Previously, various exceptions beyond just :exc:`OSError` were raised.
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
index 4107907..d19e779 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -1261,7 +1261,7 @@ Classes and functions
This function handles several details for you:
* If ``eval_str`` is true, values of type ``str`` will
- be un-stringized using :func:`eval()`. This is intended
+ be un-stringized using :func:`eval`. This is intended
for use with stringized annotations
(``from __future__ import annotations``).
* If ``obj`` doesn't have an annotations dict, returns an
@@ -1275,16 +1275,16 @@ Classes and functions
* Always, always, always returns a freshly created dict.
``eval_str`` controls whether or not values of type ``str`` are replaced
- with the result of calling :func:`eval()` on those values:
+ with the result of calling :func:`eval` on those values:
- * If eval_str is true, :func:`eval()` is called on values of type ``str``.
- (Note that ``get_annotations`` doesn't catch exceptions; if :func:`eval()`
+ * If eval_str is true, :func:`eval` is called on values of type ``str``.
+ (Note that ``get_annotations`` doesn't catch exceptions; if :func:`eval`
raises an exception, it will unwind the stack past the ``get_annotations``
call.)
* If eval_str is false (the default), values of type ``str`` are unchanged.
- ``globals`` and ``locals`` are passed in to :func:`eval()`; see the documentation
- for :func:`eval()` for more information. If ``globals`` or ``locals``
+ ``globals`` and ``locals`` are passed in to :func:`eval`; see the documentation
+ for :func:`eval` for more information. If ``globals`` or ``locals``
is ``None``, this function may replace that value with a context-specific
default, contingent on ``type(obj)``:
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 748c499..dd9224f 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -950,7 +950,7 @@ Text I/O
:class:`TextIOBase`.
*encoding* gives the name of the encoding that the stream will be decoded or
- encoded with. It defaults to :func:`locale.getencoding()`.
+ encoded with. It defaults to :func:`locale.getencoding`.
``encoding="locale"`` can be used to specify the current locale's encoding
explicitly. See :ref:`io-text-encoding` for more information.
@@ -1182,7 +1182,7 @@ re-enter a buffered object which it is already accessing, a :exc:`RuntimeError`
is raised. Note this doesn't prohibit a different thread from entering the
buffered object.
-The above implicitly extends to text files, since the :func:`open()` function
+The above implicitly extends to text files, since the :func:`open` function
will wrap a buffered object inside a :class:`TextIOWrapper`. This includes
-standard streams and therefore affects the built-in :func:`print()` function as
+standard streams and therefore affects the built-in :func:`print` function as
well.
diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst
index f58c0ea..b6fb624 100644
--- a/Doc/library/ipaddress.rst
+++ b/Doc/library/ipaddress.rst
@@ -1010,7 +1010,7 @@ The module also provides the following module level functions:
doesn't make sense. There are some times however, where you may wish to
have :mod:`ipaddress` sort these anyway. If you need to do this, you can use
- this function as the *key* argument to :func:`sorted()`.
+ this function as the *key* argument to :func:`sorted`.
*obj* is either a network or address object.
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 4793717..9bfb9e2 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -113,8 +113,8 @@ of the UTF-8 encoding:
* Use UTF-8 as the :term:`filesystem encoding <filesystem encoding and error
handler>`.
-* :func:`sys.getfilesystemencoding()` returns ``'utf-8'``.
-* :func:`locale.getpreferredencoding()` returns ``'utf-8'`` (the *do_setlocale*
+* :func:`sys.getfilesystemencoding` returns ``'utf-8'``.
+* :func:`locale.getpreferredencoding` returns ``'utf-8'`` (the *do_setlocale*
argument has no effect).
* :data:`sys.stdin`, :data:`sys.stdout`, and :data:`sys.stderr` all use
UTF-8 as their text encoding, with the ``surrogateescape``
@@ -133,8 +133,8 @@ level APIs also exhibit different default behaviours:
* Command line arguments, environment variables and filenames are decoded
to text using the UTF-8 encoding.
-* :func:`os.fsdecode()` and :func:`os.fsencode()` use the UTF-8 encoding.
-* :func:`open()`, :func:`io.open()`, and :func:`codecs.open()` use the UTF-8
+* :func:`os.fsdecode` and :func:`os.fsencode` use the UTF-8 encoding.
+* :func:`open`, :func:`io.open`, and :func:`codecs.open` use the UTF-8
encoding by default. However, they still use the strict error handler by
default so that attempting to open a binary file in text mode is likely
to raise an exception rather than producing nonsense data.
@@ -794,7 +794,7 @@ process and user.
``socket.gethostbyaddr(socket.gethostname())``.
On macOS, iOS and Android, this returns the *kernel* name and version (i.e.,
- ``'Darwin'`` on macOS and iOS; ``'Linux'`` on Android). :func:`platform.uname()`
+ ``'Darwin'`` on macOS and iOS; ``'Linux'`` on Android). :func:`platform.uname`
can be used to get the user-facing operating system name and version on iOS and
Android.
@@ -2860,7 +2860,7 @@ features:
.. versionchanged:: 3.6
Added support for the :term:`context manager` protocol and the
- :func:`~scandir.close()` method. If a :func:`scandir` iterator is neither
+ :func:`~scandir.close` method. If a :func:`scandir` iterator is neither
exhausted nor explicitly closed a :exc:`ResourceWarning` will be emitted
in its destructor.
diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index b1e9392..d696161 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -49,7 +49,7 @@ You can then step through the code following this statement, and continue
running without the debugger using the :pdbcmd:`continue` command.
.. versionchanged:: 3.7
- The built-in :func:`breakpoint()`, when called with defaults, can be used
+ The built-in :func:`breakpoint`, when called with defaults, can be used
instead of ``import pdb; pdb.set_trace()``.
::
diff --git a/Doc/library/platform.rst b/Doc/library/platform.rst
index f082393..1beb3b9 100644
--- a/Doc/library/platform.rst
+++ b/Doc/library/platform.rst
@@ -150,7 +150,7 @@ Cross Platform
On iOS and Android, this returns the user-facing OS name (i.e, ``'iOS``,
``'iPadOS'`` or ``'Android'``). To obtain the kernel name (``'Darwin'`` or
- ``'Linux'``), use :func:`os.uname()`.
+ ``'Linux'``), use :func:`os.uname`.
.. function:: system_alias(system, release, version)
@@ -165,7 +165,7 @@ Cross Platform
returned if the value cannot be determined.
On iOS and Android, this is the user-facing OS version. To obtain the
- Darwin or Linux kernel version, use :func:`os.uname()`.
+ Darwin or Linux kernel version, use :func:`os.uname`.
.. function:: uname()
diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst
index 48c6841..79c4948 100644
--- a/Doc/library/signal.rst
+++ b/Doc/library/signal.rst
@@ -425,7 +425,7 @@ The :mod:`signal` module defines the following functions:
signal to a particular Python thread would be to force a running system call
to fail with :exc:`InterruptedError`.
- Use :func:`threading.get_ident()` or the :attr:`~threading.Thread.ident`
+ Use :func:`threading.get_ident` or the :attr:`~threading.Thread.ident`
attribute of :class:`threading.Thread` objects to get a suitable value
for *thread_id*.
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 088735b..8a7cb7e 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -3477,7 +3477,7 @@ place, and instead produce new objects.
``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters
are those byte values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``.
- Unlike :func:`str.swapcase()`, it is always the case that
+ Unlike :func:`str.swapcase`, it is always the case that
``bin.swapcase().swapcase() == bin`` for the binary versions. Case
conversions are symmetrical in ASCII, even though that is not generally
true for arbitrary Unicode code points.
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index f10a808..1d5aa42 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -608,7 +608,7 @@ functions.
If *group* is not ``None``, the setregid() system call will be made in the
child process prior to the execution of the subprocess. If the provided
- value is a string, it will be looked up via :func:`grp.getgrnam()` and
+ value is a string, it will be looked up via :func:`grp.getgrnam` and
the value in ``gr_gid`` will be used. If the value is an integer, it
will be passed verbatim. (POSIX only)
@@ -618,7 +618,7 @@ functions.
If *extra_groups* is not ``None``, the setgroups() system call will be
made in the child process prior to the execution of the subprocess.
Strings provided in *extra_groups* will be looked up via
- :func:`grp.getgrnam()` and the values in ``gr_gid`` will be used.
+ :func:`grp.getgrnam` and the values in ``gr_gid`` will be used.
Integer values will be passed verbatim. (POSIX only)
.. availability:: POSIX
@@ -626,7 +626,7 @@ functions.
If *user* is not ``None``, the setreuid() system call will be made in the
child process prior to the execution of the subprocess. If the provided
- value is a string, it will be looked up via :func:`pwd.getpwnam()` and
+ value is a string, it will be looked up via :func:`pwd.getpwnam` and
the value in ``pw_uid`` will be used. If the value is an integer, it will
be passed verbatim. (POSIX only)
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 99252a8..b0e40a4 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -735,11 +735,11 @@ always available.
regardless of their size. This function is mainly useful for tracking
and debugging memory leaks. Because of the interpreter's internal
caches, the result can vary from call to call; you may have to call
- :func:`_clear_internal_caches()` and :func:`gc.collect()` to get more
+ :func:`_clear_internal_caches` and :func:`gc.collect` to get more
predictable results.
If a Python build or implementation cannot reasonably compute this
- information, :func:`getallocatedblocks()` is allowed to return 0 instead.
+ information, :func:`getallocatedblocks` is allowed to return 0 instead.
.. versionadded:: 3.4
diff --git a/Doc/library/sysconfig.rst b/Doc/library/sysconfig.rst
index 6834f66..3921908 100644
--- a/Doc/library/sysconfig.rst
+++ b/Doc/library/sysconfig.rst
@@ -305,7 +305,7 @@ Installation path functions
mix with those by the other.
End users should not use this function, but :func:`get_default_scheme` and
- :func:`get_preferred_scheme()` instead.
+ :func:`get_preferred_scheme` instead.
.. versionadded:: 3.10
diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst
index 631d869..c9d69cf 100644
--- a/Doc/library/tarfile.rst
+++ b/Doc/library/tarfile.rst
@@ -615,7 +615,7 @@ be finalized; only the internally used file object will be closed. See the
it is best practice to only do so in top-level applications or
:mod:`site configuration <site>`.
To set a global default this way, a filter function needs to be wrapped in
- :func:`staticmethod()` to prevent injection of a ``self`` argument.
+ :func:`staticmethod` to prevent injection of a ``self`` argument.
.. versionchanged:: 3.14
diff --git a/Doc/library/test.rst b/Doc/library/test.rst
index 2a61f0a..12f8604 100644
--- a/Doc/library/test.rst
+++ b/Doc/library/test.rst
@@ -1701,7 +1701,7 @@ The :mod:`test.support.warnings_helper` module provides support for warnings tes
.. function:: check_warnings(*filters, quiet=True)
- A convenience wrapper for :func:`warnings.catch_warnings()` that makes it
+ A convenience wrapper for :func:`warnings.catch_warnings` that makes it
easier to test that a warning was correctly raised. It is approximately
equivalent to calling ``warnings.catch_warnings(record=True)`` with
:meth:`warnings.simplefilter` set to ``always`` and with the option to
diff --git a/Doc/library/time.rst b/Doc/library/time.rst
index 900e78d..2457510 100644
--- a/Doc/library/time.rst
+++ b/Doc/library/time.rst
@@ -327,7 +327,7 @@ Functions
.. impl-detail::
- On CPython, use the same clock than :func:`time.monotonic()` and is a
+ On CPython, use the same clock than :func:`time.monotonic` and is a
monotonic clock, i.e. a clock that cannot go backwards.
Use :func:`perf_counter_ns` to avoid the precision loss caused by the
@@ -339,7 +339,7 @@ Functions
On Windows, the function is now system-wide.
.. versionchanged:: 3.13
- Use the same clock than :func:`time.monotonic()`.
+ Use the same clock than :func:`time.monotonic`.
.. function:: perf_counter_ns() -> int
diff --git a/Doc/library/token.rst b/Doc/library/token.rst
index 919ff59..0cc9ddd 100644
--- a/Doc/library/token.rst
+++ b/Doc/library/token.rst
@@ -75,7 +75,7 @@ the :mod:`tokenize` module.
:noindex:
Token value indicating that a type comment was recognized. Such
- tokens are only produced when :func:`ast.parse()` is invoked with
+ tokens are only produced when :func:`ast.parse` is invoked with
``type_comments=True``.
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index dc76374..c49aba6 100644
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -2529,7 +2529,7 @@ Signal Handling
.. versionadded:: 3.2
The :option:`-c/--catch <unittest -c>` command-line option to unittest,
-along with the ``catchbreak`` parameter to :func:`unittest.main()`, provide
+along with the ``catchbreak`` parameter to :func:`unittest.main`, provide
more friendly handling of control-C during a test run. With catch break
behavior enabled control-C will allow the currently running test to complete,
and the test run will then end and report all the results so far. A second
diff --git a/Doc/library/zipapp.rst b/Doc/library/zipapp.rst
index cf561b4..cdaba07 100644
--- a/Doc/library/zipapp.rst
+++ b/Doc/library/zipapp.rst
@@ -332,7 +332,7 @@ Formally, the Python zip application format is therefore:
interpreter name, and then a newline (``b'\n'``) character. The interpreter
name can be anything acceptable to the OS "shebang" processing, or the Python
launcher on Windows. The interpreter should be encoded in UTF-8 on Windows,
- and in :func:`sys.getfilesystemencoding()` on POSIX.
+ and in :func:`sys.getfilesystemencoding` on POSIX.
2. Standard zipfile data, as generated by the :mod:`zipfile` module. The
zipfile content *must* include a file called ``__main__.py`` (which must be
in the "root" of the zipfile - i.e., it cannot be in a subdirectory). The
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index f099d55..8c3134a 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -380,7 +380,7 @@ Bytes
A bytes object is an immutable array. The items are 8-bit bytes,
represented by integers in the range 0 <= x < 256. Bytes literals
- (like ``b'abc'``) and the built-in :func:`bytes()` constructor
+ (like ``b'abc'``) and the built-in :func:`bytes` constructor
can be used to create bytes objects. Also, bytes objects can be
decoded to strings via the :meth:`~bytes.decode` method.
diff --git a/Doc/tutorial/floatingpoint.rst b/Doc/tutorial/floatingpoint.rst
index 6093028..dfe2d1d 100644
--- a/Doc/tutorial/floatingpoint.rst
+++ b/Doc/tutorial/floatingpoint.rst
@@ -230,7 +230,7 @@ accumulate to the point where they affect the final total:
>>> sum([0.1] * 10) == 1.0
True
-The :func:`math.fsum()` goes further and tracks all of the "lost digits"
+The :func:`math.fsum` goes further and tracks all of the "lost digits"
as values are added onto a running total so that the result has only a
single rounding. This is slower than :func:`sum` but will be more
accurate in uncommon cases where large magnitude inputs mostly cancel
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
index 8c70cf4..66f7d5f 100644
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -1031,7 +1031,7 @@ conflict.
'surrogatepass' are used.
This may also be enabled at runtime with
- :func:`sys._enablelegacywindowsfsencoding()`.
+ :func:`sys._enablelegacywindowsfsencoding`.
.. availability:: Windows.
diff --git a/Doc/using/ios.rst b/Doc/using/ios.rst
index ad95906..455221c 100644
--- a/Doc/using/ios.rst
+++ b/Doc/using/ios.rst
@@ -53,10 +53,10 @@ the simulator or a physical device.
Information about the specific runtime environment, including the iOS version,
device model, and whether the device is a simulator, can be obtained using
-:func:`platform.ios_ver()`. :func:`platform.system()` will report ``iOS`` or
+:func:`platform.ios_ver`. :func:`platform.system` will report ``iOS`` or
``iPadOS``, depending on the device.
-:func:`os.uname()` reports kernel-level details; it will report a name of
+:func:`os.uname` reports kernel-level details; it will report a name of
``Darwin``.
Standard library availability
diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst
index b939ccd..e4699fb 100644
--- a/Doc/whatsnew/3.10.rst
+++ b/Doc/whatsnew/3.10.rst
@@ -1233,7 +1233,7 @@ also now un-stringize stringized annotations.
itertools
---------
-Add :func:`itertools.pairwise()`.
+Add :func:`itertools.pairwise`.
(Contributed by Raymond Hettinger in :issue:`38200`.)
linecache
@@ -1245,14 +1245,14 @@ When a module does not define ``__loader__``, fall back to ``__spec__.loader``.
os
--
-Add :func:`os.cpu_count()` support for VxWorks RTOS.
+Add :func:`os.cpu_count` support for VxWorks RTOS.
(Contributed by Peixing Xin in :issue:`41440`.)
Add a new function :func:`os.eventfd` and related helpers to wrap the
``eventfd2`` syscall on Linux.
(Contributed by Christian Heimes in :issue:`41001`.)
-Add :func:`os.splice()` that allows to move data between two file
+Add :func:`os.splice` that allows to move data between two file
descriptors without copying between kernel address space and user
address space, where one of the file descriptors must refer to a
pipe. (Contributed by Pablo Galindo in :issue:`41625`.)
@@ -1292,7 +1292,7 @@ functions in the :mod:`os` module.
platform
--------
-Add :func:`platform.freedesktop_os_release()` to retrieve operation system
+Add :func:`platform.freedesktop_os_release` to retrieve operation system
identification from `freedesktop.org os-release
<https://www.freedesktop.org/software/systemd/man/os-release.html>`_ standard file.
(Contributed by Christian Heimes in :issue:`28468`.)
diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
index a240c1f..dc16aa9 100644
--- a/Doc/whatsnew/3.12.rst
+++ b/Doc/whatsnew/3.12.rst
@@ -1422,9 +1422,9 @@ hashlib
-------
* Remove the pure Python implementation of :mod:`hashlib`'s
- :func:`hashlib.pbkdf2_hmac()`, deprecated in Python 3.10. Python 3.10 and
+ :func:`hashlib.pbkdf2_hmac`, deprecated in Python 3.10. Python 3.10 and
newer requires OpenSSL 1.1.1 (:pep:`644`): this OpenSSL version provides
- a C implementation of :func:`~hashlib.pbkdf2_hmac()` which is faster.
+ a C implementation of :func:`~hashlib.pbkdf2_hmac` which is faster.
(Contributed by Victor Stinner in :gh:`94199`.)
importlib
diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst
index ba18991..44b373a 100644
--- a/Doc/whatsnew/3.14.rst
+++ b/Doc/whatsnew/3.14.rst
@@ -199,7 +199,7 @@ pathlib
pdb
---
-* Hard-coded breakpoints (:func:`breakpoint` and :func:`pdb.set_trace()`) now
+* Hard-coded breakpoints (:func:`breakpoint` and :func:`pdb.set_trace`) now
reuse the most recent :class:`~pdb.Pdb` instance that calls
:meth:`~pdb.Pdb.set_trace()`, instead of creating a new one each time.
As a result, all the instance specific data like :pdbcmd:`display` and
diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst
index ac05b59..40305b7 100644
--- a/Doc/whatsnew/3.2.rst
+++ b/Doc/whatsnew/3.2.rst
@@ -2321,7 +2321,7 @@ Multi-threading
intervals and reduced overhead due to lock contention and the number of
ensuing system calls. The notion of a "check interval" to allow thread
switches has been abandoned and replaced by an absolute duration expressed in
- seconds. This parameter is tunable through :func:`sys.setswitchinterval()`.
+ seconds. This parameter is tunable through :func:`sys.setswitchinterval`.
It currently defaults to 5 milliseconds.
Additional details about the implementation can be read from a `python-dev
diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
index 5df976d..95b89e7 100644
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -779,8 +779,8 @@ Other Language Changes
Some smaller changes made to the core Python language are:
* Added support for Unicode name aliases and named sequences.
- Both :func:`unicodedata.lookup()` and ``'\N{...}'`` now resolve name aliases,
- and :func:`unicodedata.lookup()` resolves named sequences too.
+ Both :func:`unicodedata.lookup` and ``'\N{...}'`` now resolve name aliases,
+ and :func:`unicodedata.lookup` resolves named sequences too.
(Contributed by Ezio Melotti in :issue:`12753`.)
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index 938dd27..fbfcb87 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -1967,7 +1967,7 @@ Other Improvements
* The ``-R`` option to the :ref:`python regression test suite <regrtest>` now
also checks for memory allocation leaks, using
- :func:`sys.getallocatedblocks()`. (Contributed by Antoine Pitrou in
+ :func:`sys.getallocatedblocks`. (Contributed by Antoine Pitrou in
:issue:`13390`.)
* ``python -m`` now works with namespace packages.
diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst
index 35352c7..be83aa8 100644
--- a/Doc/whatsnew/3.6.rst
+++ b/Doc/whatsnew/3.6.rst
@@ -511,10 +511,10 @@ correct.
Prior to Python 3.6, data loss could result when using bytes paths on Windows.
With this change, using bytes to represent paths is now supported on Windows,
provided those bytes are encoded with the encoding returned by
-:func:`sys.getfilesystemencoding()`, which now defaults to ``'utf-8'``.
+:func:`sys.getfilesystemencoding`, which now defaults to ``'utf-8'``.
Applications that do not use str to represent paths should use
-:func:`os.fsencode()` and :func:`os.fsdecode()` to ensure their bytes are
+:func:`os.fsencode` and :func:`os.fsdecode` to ensure their bytes are
correctly encoded. To revert to the previous behaviour, set
:envvar:`PYTHONLEGACYWINDOWSFSENCODING` or call
:func:`sys._enablelegacywindowsfsencoding`.
@@ -780,7 +780,7 @@ for managing secrets, such as account authentication, tokens, and similar.
Note that the pseudo-random generators in the :mod:`random` module
should *NOT* be used for security purposes. Use :mod:`secrets`
- on Python 3.6+ and :func:`os.urandom()` on Python 3.5 and earlier.
+ on Python 3.6+ and :func:`os.urandom` on Python 3.5 and earlier.
.. seealso::
@@ -1316,7 +1316,7 @@ Storchaka in :issue:`24164`.)
pickletools
-----------
-:func:`pickletools.dis()` now outputs the implicit memo index for the
+:func:`pickletools.dis` now outputs the implicit memo index for the
``MEMOIZE`` opcode.
(Contributed by Serhiy Storchaka in :issue:`25382`.)
diff --git a/Doc/whatsnew/3.7.rst b/Doc/whatsnew/3.7.rst
index ab460ed..6333fcf 100644
--- a/Doc/whatsnew/3.7.rst
+++ b/Doc/whatsnew/3.7.rst
@@ -2366,7 +2366,7 @@ Changes in the Python API
positions 2--3. To match only blank lines, the pattern should be rewritten
as ``r'(?m)^[^\S\n]*$'``.
- :func:`re.sub()` now replaces empty matches adjacent to a previous
+ :func:`re.sub` now replaces empty matches adjacent to a previous
non-empty match. For example ``re.sub('x*', '-', 'abxd')`` returns now
``'-a-b--d-'`` instead of ``'-a-b-d-'`` (the first minus between 'b' and
'd' replaces 'x', and the second minus replaces an empty string between
diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index bf5e277..553e5da 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -936,7 +936,7 @@ Add option ``--json-lines`` to parse every input line as a separate JSON object.
logging
-------
-Added a *force* keyword argument to :func:`logging.basicConfig()`
+Added a *force* keyword argument to :func:`logging.basicConfig`
When set to true, any existing handlers attached
to the root logger are removed and closed before carrying out the
configuration specified by the other arguments.
@@ -1175,8 +1175,8 @@ convenience functions to automate the necessary tasks usually involved when
creating a server socket, including accepting both IPv4 and IPv6 connections
on the same socket. (Contributed by Giampaolo Rodolà in :issue:`17561`.)
-The :func:`socket.if_nameindex()`, :func:`socket.if_nametoindex()`, and
-:func:`socket.if_indextoname()` functions have been implemented on Windows.
+The :func:`socket.if_nameindex`, :func:`socket.if_nametoindex`, and
+:func:`socket.if_indextoname` functions have been implemented on Windows.
(Contributed by Zackery Spytz in :issue:`37007`.)
@@ -1193,10 +1193,10 @@ statistics
----------
Added :func:`statistics.fmean` as a faster, floating-point variant of
-:func:`statistics.mean()`. (Contributed by Raymond Hettinger and
+:func:`statistics.mean`. (Contributed by Raymond Hettinger and
Steven D'Aprano in :issue:`35904`.)
-Added :func:`statistics.geometric_mean()`
+Added :func:`statistics.geometric_mean`
(Contributed by Raymond Hettinger in :issue:`27181`.)
Added :func:`statistics.multimode` that returns a list of the most
@@ -1367,9 +1367,9 @@ Added :class:`~unittest.mock.AsyncMock` to support an asynchronous version of
have been added as well.
(Contributed by Lisa Roach in :issue:`26467`).
-Added :func:`~unittest.addModuleCleanup()` and
+Added :func:`~unittest.addModuleCleanup` and
:meth:`~unittest.TestCase.addClassCleanup()` to unittest to support
-cleanups for :func:`~unittest.setUpModule()` and
+cleanups for :func:`~unittest.setUpModule` and
:meth:`~unittest.TestCase.setUpClass()`.
(Contributed by Lisa Roach in :issue:`24412`.)
@@ -1432,7 +1432,7 @@ and ``{namespace}*`` which returns all tags in the given namespace.
(Contributed by Stefan Behnel in :issue:`28238`.)
The :mod:`xml.etree.ElementTree` module provides a new function
-:func:`–xml.etree.ElementTree.canonicalize()` that implements C14N 2.0.
+:func:`–xml.etree.ElementTree.canonicalize` that implements C14N 2.0.
(Contributed by Stefan Behnel in :issue:`13611`.)
The target object of :class:`xml.etree.ElementTree.XMLParser` can
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index 1bce90d..d59a30c 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -983,7 +983,7 @@ Removed
(Contributed by Victor Stinner in :issue:`37312`.)
* ``aifc.openfp()`` alias to ``aifc.open()``, ``sunau.openfp()`` alias to
- ``sunau.open()``, and ``wave.openfp()`` alias to :func:`wave.open()` have been
+ ``sunau.open()``, and ``wave.openfp()`` alias to :func:`wave.open` have been
removed. They were deprecated since Python 3.7.
(Contributed by Victor Stinner in :issue:`37320`.)