From: Georg Brandl <georg@python.org>
Date: Sat, 31 May 2008 14:40:09 +0000 (+0000)
Subject: #3010: clarification about stdin/use_rawinput.
X-Git-Tag: v2.6b1~187
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a7ac20f8a51e6bb4b13d4f682ce42fe82394e677;p=python

#3010: clarification about stdin/use_rawinput.
---

diff --git a/Doc/library/cmd.rst b/Doc/library/cmd.rst
index 738214f389..5782b5bfae 100644
--- a/Doc/library/cmd.rst
+++ b/Doc/library/cmd.rst
@@ -26,7 +26,12 @@ interface.
 
    The optional arguments *stdin* and *stdout* specify the  input and output file
    objects that the Cmd instance or subclass  instance will use for input and
-   output. If not specified, they will default to *sys.stdin* and *sys.stdout*.
+   output. If not specified, they will default to :data:`sys.stdin` and
+   :data:`sys.stdout`.
+
+   If you want a given *stdin* to be used, make sure to set the instance's
+   :attr:`use_rawinput` attribute to ``False``, otherwise *stdin* will be
+   ignored.
 
    .. versionchanged:: 2.3
       The *stdin* and *stdout* parameters were added.