New submission from Mark Tomczak: The help documentation for the popen2.Popen3 class includes the following information:
class Popen3 | Class representing a child process. Normally instances are created | by the factory functions popen2() and popen3(). This information is misleading because the function popen2.popen3 actually returns a tuple of file objects (child_stdout, child_stdin, child_stderr), not an instance of class Popen3. Additionally, some of the properties of class Popen3 are monkey-patched into the instance when it is created and so do not appear in a dir(popen2.Popen3) call on the class itself. This means that some automatic documentation generators seem to fail to list these properties of the runtime Popen3 instance, as they are not apparent in the class definition. I suggest adding a note in the documentation of popen2.Popen3 to refer users to the manual page http://docs.python.org/lib/popen3-objects.html. An example of usage that takes into account the monkey-patched properties would also be helpful. ---------- components: Documentation messages: 58440 nosy: mtomczak severity: minor status: open title: popen2.Popen3 class (Unix) documentation misleading / confusing type: behavior versions: Python 2.1.1, Python 2.1.2, Python 2.2, Python 2.2.1, Python 2.2.2, Python 2.2.3, Python 2.3, Python 2.4, Python 2.5 __________________________________ Tracker <[EMAIL PROTECTED]> <http://bugs.python.org/issue1591> __________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com