[Python-checkins] bpo-26228: [doc] Adapt PTY documentation updates from GH-4167 (GH-27754)

[miss-islington]

https://github.com/python/cpython/commit/d4128485d6c2cbfebe756f3eeec2c60137b63bba
commit: d4128485d6c2cbfebe756f3eeec2c60137b63bba
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2021-08-13T04:21:06-07:00
summary:

bpo-26228: [doc] Adapt PTY documentation updates from GH-4167 (GH-27754)


Co-authored-by: Cornelius Diekmann <c.diekmann at googlemail.com>
(cherry picked from commit dd8eb303b90d63e1f56684bedadca6674bb74a29)

Co-authored-by: Łukasz Langa <lukasz at langa.pl>

files:
M Doc/library/pty.rst
M Lib/pty.py
M Misc/NEWS.d/next/Library/2019-02-26-09-31-59.bpo-26228.wyrHKc.rst

diff --git a/Doc/library/pty.rst b/Doc/library/pty.rst
index 4b49d244038eb..7f4da41e93802 100644
--- a/Doc/library/pty.rst
+++ b/Doc/library/pty.rst
@@ -2,8 +2,8 @@
 ========================================
 
 .. module:: pty
-   :platform: Linux
-   :synopsis: Pseudo-Terminal Handling for Linux.
+   :platform: Unix
+   :synopsis: Pseudo-Terminal Handling for Unix.
 
 .. moduleauthor:: Steen Lumholt
 .. sectionauthor:: Moshe Zadka <moshez at zadka.site.co.il>
@@ -16,9 +16,9 @@ The :mod:`pty` module defines operations for handling the pseudo-terminal
 concept: starting another process and being able to write to and read from its
 controlling terminal programmatically.
 
-Because pseudo-terminal handling is highly platform dependent, there is code to
-do it only for Linux. (The Linux code is supposed to work on other platforms,
-but hasn't been tested yet.)
+Pseudo-terminal handling is highly platform dependent. This code is mainly
+tested on Linux, FreeBSD, and macOS (it is supposed to work on other POSIX
+platforms but it's not been thoroughly tested).
 
 The :mod:`pty` module defines the following functions:
 
@@ -47,6 +47,10 @@ The :mod:`pty` module defines the following functions:
    spawned behind the pty will eventually terminate, and when it does *spawn*
    will return.
 
+   A loop copies STDIN of the current process to the child and data received
+   from the child to STDOUT of the current process. It is not signaled to the
+   child if STDIN of the current process closes down.
+
    The functions *master_read* and *stdin_read* are passed a file descriptor
    which they should read from, and they should always return a byte string. In
    order to force spawn to return before the child process exits an
diff --git a/Lib/pty.py b/Lib/pty.py
index 43e974fff1c90..8d8ce40df541c 100644
--- a/Lib/pty.py
+++ b/Lib/pty.py
@@ -1,7 +1,7 @@
 """Pseudo terminal utilities."""
 
 # Bugs: No signal handling.  Doesn't set slave termios and window size.
-#       Only tested on Linux.
+#       Only tested on Linux, FreeBSD, and macOS.
 # See:  W. Richard Stevens. 1992.  Advanced Programming in the
 #       UNIX Environment.  Chapter 19.
 # Author: Steen Lumholt -- with additions by Guido.
diff --git a/Misc/NEWS.d/next/Library/2019-02-26-09-31-59.bpo-26228.wyrHKc.rst b/Misc/NEWS.d/next/Library/2019-02-26-09-31-59.bpo-26228.wyrHKc.rst
index 43ff580bcfaf6..c6ca84ae3b639 100644
--- a/Misc/NEWS.d/next/Library/2019-02-26-09-31-59.bpo-26228.wyrHKc.rst
+++ b/Misc/NEWS.d/next/Library/2019-02-26-09-31-59.bpo-26228.wyrHKc.rst
@@ -1 +1 @@
-pty.spawn no longer hangs on FreeBSD, OS X, and Solaris.
\ No newline at end of file
+pty.spawn no longer hangs on FreeBSD, macOS, and Solaris.