Commit 2aefe8d7 authored by Guido van Rossum's avatar Guido van Rossum

Document changed semantics -- open() now guesses the db type and error

is now a tuple of various and sundry exceptions.
parent fc1f64d9
......@@ -11,6 +11,12 @@ be used.
\begin{funcdesc}{open}{filename\optional{, flag\optional{, mode}}}
Open the database file \var{filename} and return a corresponding object.
If the database file already exists, the \module{whichdb} module is
used to determine its type and the appropriate module is used; if it
doesn't exist, the first module listed above that can be imported is
used.
The optional \var{flag} argument can be
\code{'r'} to open an existing database for reading only,
\code{'w'} to open an existing database for reading and writing,
......@@ -24,8 +30,10 @@ only when the database has to be created. It defaults to octal
\end{funcdesc}
\begin{excdesc}{error}
An alternate name for the \exception{error} exception defined by the
underlying database implementation.
A tuple containing the exceptions that can be raised by each of the
supported modules, with a unique exception \exception{anydbm.error} as
the first item --- the latter is used when \exception{anydbm.error} is
raised.
\end{excdesc}
The object returned by \function{open()} supports most of the same
......
......@@ -11,6 +11,12 @@ be used.
\begin{funcdesc}{open}{filename\optional{, flag\optional{, mode}}}
Open the database file \var{filename} and return a corresponding object.
If the database file already exists, the \module{whichdb} module is
used to determine its type and the appropriate module is used; if it
doesn't exist, the first module listed above that can be imported is
used.
The optional \var{flag} argument can be
\code{'r'} to open an existing database for reading only,
\code{'w'} to open an existing database for reading and writing,
......@@ -24,8 +30,10 @@ only when the database has to be created. It defaults to octal
\end{funcdesc}
\begin{excdesc}{error}
An alternate name for the \exception{error} exception defined by the
underlying database implementation.
A tuple containing the exceptions that can be raised by each of the
supported modules, with a unique exception \exception{anydbm.error} as
the first item --- the latter is used when \exception{anydbm.error} is
raised.
\end{excdesc}
The object returned by \function{open()} supports most of the same
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment