[New-bugs-announce] [issue18249] Incorrect and incomplete help docs for close() method

[Dave Angel]

New submission from Dave Angel:

Python 3.3.0 (default, Mar  7 2013, 00:24:38) 
[GCC 4.6.3] on linux

q = open('/dev/null')
help(q.close)

the entire output is:
-------------------------------
Help on built-in function close:

close(...)
(END)
-------------------------------

But close() is NOT a built-in, it's a method.

(In Python 2.7.*  the output is:

-------------------------------
Help on built-in function close:

close(...)
    close() -> None or (perhaps) an integer.  Close the file.
    
    Sets data attribute .closed to True.  A closed file cannot be used for
    further I/O operations.  close() may be called more than once without
    error.  Some kinds of file objects (for example, opened by popen())
    may return an exit status upon closing.
(END)
-------------------------------
which is only partially wrong.

----------
assignee: docs at python
components: Documentation
messages: 191382
nosy: DaveA, docs at python
priority: normal
severity: normal
status: open
title: Incorrect and incomplete help docs for close() method

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue18249>
_______________________________________