SF patch 1094011: Docs for file() vs open().

This commit is contained in:
Raymond Hettinger 2005-01-07 04:33:44 +00:00
parent bccc9a956a
commit 72b83c86a9

View file

@ -416,9 +416,12 @@ class C:
after any I/O has been performed, and there's no reliable way to
determine whether this is the case.}
The \function{file()} constructor is new in Python 2.2. The previous
spelling, \function{open()}, is retained for compatibility, and is an
alias for \function{file()}.
The \function{file()} constructor is new in Python 2.2 and is an
alias for \function{open()}. Both spellings are equivalent. The
intent is for \function{open()} to continue to be preferred for use
as a factory function which returns a new \class{file} object. The
spelling, \class{file} is more suited to type testing (for example,
writing \samp{isinstance(f, file)}).
\end{funcdesc}
\begin{funcdesc}{filter}{function, list}