summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/overview.rst14
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/overview.rst b/doc/overview.rst
index d394ef1..eca8565 100644
--- a/doc/overview.rst
+++ b/doc/overview.rst
@@ -249,9 +249,19 @@ Pexpect on Windows
Pexpect can be used on Windows to wait for a pattern to be produced by a child
process, using :class:`pexpect.popen_spawn.PopenSpawn`, or a file descriptor,
-using :class:`pexpect.fdpexpect.fdspawn`. This should be considered experimental
-for now.
+using :class:`pexpect.fdpexpect.fdspawn`.
:class:`pexpect.spawn` and :func:`pexpect.run` are *not* available on Windows,
as they rely on Unix pseudoterminals (ptys). Cross platform code must not use
these.
+
+``PopenSpawn`` is not a direct replacement for ``spawn``. Many programs only
+offer interactive behaviour if they detect that they are running in a terminal.
+When run by ``PopenSpawn``, they may behave differently.
+
+.. seealso::
+
+ `winpexpect <https://pypi.python.org/pypi/winpexpect>`__ and
+ `wexpect <https://gist.github.com/anthonyeden/8488763>`__
+ Two unmaintained pexpect-like modules for Windows, which work with a
+ hidden console.