From eef2cd14c92d37aadc31ec283882d03204c3f5c6 Mon Sep 17 00:00:00 2001
From: Barry Warsaw <barry@python.org>
Date: Thu, 23 Jul 1998 19:50:09 +0000
Subject: [PATCH] Updated the description of os.error to reflect the fact that
it is now equivalent to exceptions.OSError.
---
Doc/lib/libposix.tex | 17 +++++++++++------
1 file changed, 11 insertions(+), 6 deletions(-)
diff --git a/Doc/lib/libposix.tex b/Doc/lib/libposix.tex
index b7d49b9014a..dbfc69224ad 100644
--- a/Doc/lib/libposix.tex
+++ b/Doc/lib/libposix.tex
@@ -25,9 +25,11 @@ The descriptions below are very terse; refer to the corresponding
\UNIX{} manual (or \POSIX{} documentation) entry for more information.
Arguments called \var{path} refer to a pathname given as a string.
-Errors are reported as exceptions; the usual exceptions are given
-for type errors, while errors reported by the system calls raise
-\exception{error}, described below.
+Errors are reported as exceptions; the usual exceptions are given for
+type errors, while errors reported by the system calls raise
+\exception{error} (a synonym for the standard exception
+\exception{OSError}), described
+below.
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,
\member{errno} and \member{strerror}. The first holds the value of
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
-\code{'os.error'}; this reflects the more portable access to the
-exception through the \module{os} module.
+\code{'OSError'}.
\end{excdesc}
It defines the following functions and constants:
--
2.30.9