Updated the description of os.error to reflect the fact that it is now

equivalent to exceptions.OSError.
This commit is contained in:
Barry Warsaw 1998-07-23 19:50:09 +00:00
parent 27467e4b7e
commit eef2cd14c9
1 changed files with 11 additions and 6 deletions

View File

@ -25,9 +25,11 @@ The descriptions below are very terse; refer to the corresponding
\UNIX{} manual (or \POSIX{} documentation) entry for more information. \UNIX{} manual (or \POSIX{} documentation) entry for more information.
Arguments called \var{path} refer to a pathname given as a string. Arguments called \var{path} refer to a pathname given as a string.
Errors are reported as exceptions; the usual exceptions are given Errors are reported as exceptions; the usual exceptions are given for
for type errors, while errors reported by the system calls raise type errors, while errors reported by the system calls raise
\exception{error}, described below. \exception{error} (a synonym for the standard exception
\exception{OSError}), described
below.
Module \module{posix} defines the following data items: Module \module{posix} defines the following data items:
@ -66,11 +68,14 @@ error codes defined by the underlying operating system.
When exceptions are classes, this exception carries two attributes, When exceptions are classes, this exception carries two attributes,
\member{errno} and \member{strerror}. The first holds the value of \member{errno} and \member{strerror}. The first holds the value of
the \C{} \cdata{errno} variable, and the latter holds the the \C{} \cdata{errno} variable, and the latter holds the
corresponding error message from \cfunction{strerror()}. corresponding error message from \cfunction{strerror()}. For
exceptions that involve a file system path (e.g. \code{chdir} or
\code{unlink}), the exception instance will contain a third attribute
\member{filename} which is the file name passed to the
function.
When exceptions are strings, the string for the exception is When exceptions are strings, the string for the exception is
\code{'os.error'}; this reflects the more portable access to the \code{'OSError'}.
exception through the \module{os} module.
\end{excdesc} \end{excdesc}
It defines the following functions and constants: It defines the following functions and constants: