From a776cea71af5cc61eb2d1ed24d962191ff343dde Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Mon, 6 Nov 2000 20:17:37 +0000 Subject: [PATCH] Document the proper exception to be raised by I/O operations on closed files; error reported by Ng Pheng Siong . Make sure that various special object attributes are properly indexed. --- Doc/lib/libstdtypes.tex | 34 +++++++++++++++++++--------------- 1 file changed, 19 insertions(+), 15 deletions(-) diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex index fcee52f8d3a..003a454dff0 100644 --- a/Doc/lib/libstdtypes.tex +++ b/Doc/lib/libstdtypes.tex @@ -972,6 +972,7 @@ special operations. There is exactly one ellipsis object, named It is written as \code{Ellipsis}. + \subsubsection{File Objects\obindex{file} \label{bltin-file-objects}} @@ -995,8 +996,8 @@ Files have the following methods: \begin{methoddesc}[file]{close}{} Close the file. A closed file cannot be read or written anymore. - Any operation which requires that the file be open will raise an - \exception{IOError} after the file has been closed. Calling + Any operation which requires that the file be open will raise a + \exception{ValueError} after the file has been closed. Calling \method{close()} more than once is allowed. \end{methoddesc} @@ -1137,6 +1138,7 @@ implemented in C will have to provide a writable \keyword{print} to keep track of its internal state. \end{memberdesc} + \subsubsection{Internal Objects \label{typesinternal}} See the \citetitle[../ref/ref.html]{Python Reference Manual} for this @@ -1149,26 +1151,28 @@ slice objects. The implementation adds a few special read-only attributes to several object types, where they are relevant: -\begin{memberdescni}{__dict__} -A dictionary of some sort used to store an +\begin{memberdesc}[object]{__dict__} +A dictionary or other mapping object used to store an object's (writable) attributes. -\end{memberdescni} +\end{memberdesc} -\begin{memberdescni}{__methods__} +\begin{memberdesc}[object]{__methods__} List of the methods of many built-in object types, e.g., \code{[].__methods__} yields \code{['append', 'count', 'index', 'insert', 'pop', 'remove', -'reverse', 'sort']}. -\end{memberdescni} +'reverse', 'sort']}. This usually does not need to be explicitly +provided by the object. +\end{memberdesc} -\begin{memberdescni}{__members__} -Similar to \member{__methods__}, but lists data attributes. -\end{memberdescni} +\begin{memberdesc}[object]{__members__} +Similar to \member{__methods__}, but lists data attributes. This +usually does not need to be explicitly provided by the object. +\end{memberdesc} -\begin{memberdescni}{__class__} +\begin{memberdesc}[instance]{__class__} The class to which a class instance belongs. -\end{memberdescni} +\end{memberdesc} -\begin{memberdescni}{__bases__} +\begin{memberdesc}[class]{__bases__} The tuple of base classes of a class object. -\end{memberdescni} +\end{memberdesc}