https://github.com/python/cpython/commit/312222feebbcf574b5f1759ac8ae75762f2e8b4e commit: 312222feebbcf574b5f1759ac8ae75762f2e8b4e branch: main author: Harjoth Khara <[email protected]> committer: asvetlov <[email protected]> date: 2026-10-28T13:25:33+01:00 summary:
gh-151950: Fix Sphinx reference warnings in termios docs (#153885) Document the VMIN/VTIME, TCIFLUSH/TCOFLUSH/TCIOFLUSH, TCOOFF/TCOON/TCIOFF/TCION and TIOC* window-size constants with ``.. data::`` directives so the ``:const:`` references resolve, and drop termios.rst from Doc/tools/.nitignore. Co-authored-by: Claude Sonnet 5.5 <[email protected]> files: M Doc/library/termios.rst M Doc/tools/.nitignore diff --git a/Doc/library/termios.rst b/Doc/library/termios.rst index 537dfcedd8cf5a..1db8ec0b6a341f 100644 --- a/Doc/library/termios.rst +++ b/Doc/library/termios.rst @@ -39,6 +39,13 @@ The module defines the following functions: well as the indexing in the *cc* array must be done using the symbolic constants defined in the :mod:`!termios` module. + .. data:: VMIN + VTIME + + Indices into the *cc* array controlling a non-canonical read: the minimum + number of characters to read and the timeout in tenths of a second, + respectively. + .. function:: tcsetattr(fd, when, attributes) @@ -77,6 +84,13 @@ The module defines the following functions: which queue: :const:`TCIFLUSH` for the input queue, :const:`TCOFLUSH` for the output queue, or :const:`TCIOFLUSH` for both queues. + .. data:: TCIFLUSH + TCOFLUSH + TCIOFLUSH + + Values for the *queue* selector: the input queue, the output queue, or + both queues, respectively. + .. function:: tcflow(fd, action) @@ -84,6 +98,14 @@ The module defines the following functions: argument can be :const:`TCOOFF` to suspend output, :const:`TCOON` to restart output, :const:`TCIOFF` to suspend input, or :const:`TCION` to restart input. + .. data:: TCOOFF + TCOON + TCIOFF + TCION + + Values for the *action* argument: suspend output, restart output, + suspend input, or restart input, respectively. + .. function:: tcgetwinsize(fd) @@ -93,6 +115,12 @@ The module defines the following functions: .. versionadded:: 3.11 + .. data:: TIOCGWINSZ + TIOCGSIZE + + ``ioctl()`` requests for querying the tty window size. Not defined on + all platforms; :func:`tcgetwinsize` requires at least one of them. + .. function:: tcsetwinsize(fd, winsize) @@ -104,6 +132,12 @@ The module defines the following functions: .. versionadded:: 3.11 + .. data:: TIOCSWINSZ + TIOCSSIZE + + ``ioctl()`` requests for setting the tty window size. Not defined on all + platforms; see :func:`tcsetwinsize` for the required pairs. + .. seealso:: diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index 4e0adc58183210..9bd913b47cabb9 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -13,7 +13,6 @@ Doc/library/pyexpat.rst Doc/library/select.rst Doc/library/socket.rst Doc/library/ssl.rst -Doc/library/termios.rst Doc/library/urllib.parse.rst Doc/library/urllib.request.rst Doc/library/wsgiref.rst _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
