[issue1510] help for file/open should state which is prefered.

[cfk]

New submission from cfk:

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.

----------
components: Documentation
messages: 57901
nosy: carlfk
severity: minor
status: open
title: help for file/open should state which is prefered.
versions: Python 2.6

__________________________________
Tracker <report at bugs.python.org>
<http://bugs.python.org/issue1510>
__________________________________