From 005e889cbd8b895408c7496fc6a7a6c83207c941 Mon Sep 17 00:00:00 2001 From: Yuki Kobayashi Date: Mon, 10 Mar 2025 21:38:08 +0900 Subject: [PATCH] [3.13] gh-101100: Fix sphinx warnings in `library/asyncio-subprocess.rst` (GH-130994) (cherry picked from commit 7cc99a54b755cc7cc0b3680fde7834cf612d4fbc) Co-authored-by: Yuki Kobayashi --- Doc/library/asyncio-subprocess.rst | 20 ++++++++++---------- Doc/tools/.nitignore | 1 - 2 files changed, 10 insertions(+), 11 deletions(-) diff --git a/Doc/library/asyncio-subprocess.rst b/Doc/library/asyncio-subprocess.rst index 57982a37391a0d..0828607b61d1ee 100644 --- a/Doc/library/asyncio-subprocess.rst +++ b/Doc/library/asyncio-subprocess.rst @@ -68,7 +68,7 @@ Creating Subprocesses Create a subprocess. The *limit* argument sets the buffer limit for :class:`StreamReader` - wrappers for :attr:`Process.stdout` and :attr:`Process.stderr` + wrappers for :attr:`~asyncio.subprocess.Process.stdout` and :attr:`~asyncio.subprocess.Process.stderr` (if :const:`subprocess.PIPE` is passed to *stdout* and *stderr* arguments). Return a :class:`~asyncio.subprocess.Process` instance. @@ -87,7 +87,7 @@ Creating Subprocesses Run the *cmd* shell command. The *limit* argument sets the buffer limit for :class:`StreamReader` - wrappers for :attr:`Process.stdout` and :attr:`Process.stderr` + wrappers for :attr:`~asyncio.subprocess.Process.stdout` and :attr:`~asyncio.subprocess.Process.stderr` (if :const:`subprocess.PIPE` is passed to *stdout* and *stderr* arguments). Return a :class:`~asyncio.subprocess.Process` instance. @@ -132,12 +132,12 @@ Constants If *PIPE* is passed to *stdin* argument, the :attr:`Process.stdin ` attribute - will point to a :class:`StreamWriter` instance. + will point to a :class:`~asyncio.StreamWriter` instance. If *PIPE* is passed to *stdout* or *stderr* arguments, the :attr:`Process.stdout ` and :attr:`Process.stderr ` - attributes will point to :class:`StreamReader` instances. + attributes will point to :class:`~asyncio.StreamReader` instances. .. data:: asyncio.subprocess.STDOUT :module: @@ -165,7 +165,7 @@ their completion. :module: An object that wraps OS processes created by the - :func:`create_subprocess_exec` and :func:`create_subprocess_shell` + :func:`~asyncio.create_subprocess_exec` and :func:`~asyncio.create_subprocess_shell` functions. This class is designed to have a similar API to the @@ -263,24 +263,24 @@ their completion. Kill the child process. - On POSIX systems this method sends :py:data:`SIGKILL` to the child + On POSIX systems this method sends :py:data:`~signal.SIGKILL` to the child process. On Windows this method is an alias for :meth:`terminate`. .. attribute:: stdin - Standard input stream (:class:`StreamWriter`) or ``None`` + Standard input stream (:class:`~asyncio.StreamWriter`) or ``None`` if the process was created with ``stdin=None``. .. attribute:: stdout - Standard output stream (:class:`StreamReader`) or ``None`` + Standard output stream (:class:`~asyncio.StreamReader`) or ``None`` if the process was created with ``stdout=None``. .. attribute:: stderr - Standard error stream (:class:`StreamReader`) or ``None`` + Standard error stream (:class:`~asyncio.StreamReader`) or ``None`` if the process was created with ``stderr=None``. .. warning:: @@ -296,7 +296,7 @@ their completion. Process identification number (PID). - Note that for processes created by the :func:`create_subprocess_shell` + Note that for processes created by the :func:`~asyncio.create_subprocess_shell` function, this attribute is the PID of the spawned shell. .. attribute:: returncode diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index 71f80e167d545d..3e56c939e5b2cf 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -15,7 +15,6 @@ Doc/extending/extending.rst Doc/library/ast.rst Doc/library/asyncio-extending.rst Doc/library/asyncio-policy.rst -Doc/library/asyncio-subprocess.rst Doc/library/decimal.rst Doc/library/email.charset.rst Doc/library/email.compat32-message.rst