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@python
components: Documentation
messages: 191382
nosy: DaveA, docs@python
priority: normal
severity: normal
status: open
title: Incorrect and incomplete help docs for close() method

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue18249>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to