Issue 1510: help for file/open should state which is prefered. (original) (raw)

bltinmodule.c:

PyDoc_STRVAR(open_doc, "open(name[, mode[, buffering]]) -> file object\n
\n
Open a file using the file() type, returns a file object.");

Help for file() is detailed, which would lead people to use file over open. given that file() is removed in py3k, I think that should be mentioned in the current file() docstring, and swap the help for file/open.