[issue8709] mention explicitly Windows support for os.devnull
New submission from akira <4kir4.1i@gmail.com>: Currently it is not obvious that os.devnull works on Windows. ---------- assignee: docs@python components: Documentation files: doc-os-devnull-windows-r81160.diff keywords: patch messages: 105688 nosy: akira, docs@python priority: normal severity: normal status: open title: mention explicitly Windows support for os.devnull type: feature request Added file: http://bugs.python.org/file17331/doc-os-devnull-windows-r81160.diff _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8709> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment: If there’s no note stating some object is only available on one platform, then it’s available for all. That said, for this case I agree with your patch. ---------- nosy: +merwok _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8709> _______________________________________
Terry J. Reedy <tjreedy@udel.edu> added the comment: Given the mention of the posix example, I agree. The issue applies to 2.6 and 3.2 (that I checked) and so I assume to 2.7 and 3.1 also. There is no doc string for devnull, which I presume should be in ntpath.
help(os.devnull) no Python documentation found for 'nul'
If this is a singular omission (as opposed to a general lack in that module), you might expand the patch to remedy that also. ---------- nosy: +tjreedy stage: -> commit review versions: +Python 2.6, Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8709> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment: os.devnull is a string, so “pydoc os.devnull” will tell you about strings, and “help(os.devnull)” will be evaluated to “help('/dev/null')” which won’t match any topic. Same thing with os.sep and other module data; the doc is in the module’s docstring. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8709> _______________________________________
Georg Brandl <georg@python.org> added the comment: Thanks, applied in r81450. ---------- nosy: +georg.brandl resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8709> _______________________________________
participants (4)
-
akira -
Georg Brandl
-
Terry J. Reedy
-
Éric Araujo