traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

#9397: remove mention of dbm.bsd which does not exist anymore.

This commit is contained in:
Georg Brandl 2010-07-29 14:46:07 +00:00
parent 933b974a41
commit ac958ce05e
1 changed files with 10 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
Doc/library/dbm.rst
View File

@ -5,10 +5,10 @@
:synopsis: Interfaces to various Unix "database" formats. :synopsis: Interfaces to various Unix "database" formats.
:mod:`dbm` is a generic interface to variants of the DBM database --- :mod:`dbm` is a generic interface to variants of the DBM database ---
:mod:`dbm.gnu` or :mod:`dbm.ndbm`. If none of these modules is installed, the :mod:`dbm.gnu` or :mod:`dbm.ndbm`. If none of these modules is installed, the
slow-but-simple implementation in module :mod:`dbm.dumb` will be used. There slow-but-simple implementation in module :mod:`dbm.dumb` will be used. There
is a `third party interface <http://www.jcea.es/programacion/pybsddb.htm>`_ to is a `third party interface <http://www.jcea.es/programacion/pybsddb.htm>`_ to
the Oracle Berkely DB. the Oracle Berkely DB.
.. exception:: error .. exception:: error
@ -21,8 +21,8 @@
.. function:: whichdb(filename) .. function:: whichdb(filename)
This functionattempts to guess which of the several simple database modules This functionattempts to guess which of the several simple database modules
available --- :mod:`dbm.bsd`, :mod:`dbm.gnu`, :mod:`dbm.ndbm` or available --- :mod:`dbm.gnu`, :mod:`dbm.ndbm` or :mod:`dbm.dumb` --- should
:mod:`dbm.dumb` --- should be used to open a given file. be used to open a given file.
Returns one of the following values: ``None`` if the file can't be opened Returns one of the following values: ``None`` if the file can't be opened
because it's unreadable or doesn't exist; the empty string (``''``) if the because it's unreadable or doesn't exist; the empty string (``''``) if the
@ -227,10 +227,9 @@ Dbm objects behave like mappings (dictionaries), except that keys and values are
always stored as bytes. Printing a ``dbm`` object doesn't print the keys and always stored as bytes. Printing a ``dbm`` object doesn't print the keys and
values, and the :meth:`items` and :meth:`values` methods are not supported. values, and the :meth:`items` and :meth:`values` methods are not supported.
This module can be used with the "classic" ndbm interface, the BSD DB This module can be used with the "classic" ndbm interface or the GNU GDBM
compatibility interface, or the GNU GDBM compatibility interface. On Unix, the compatibility interface. On Unix, the :program:`configure` script will attempt
:program:`configure` script will attempt to locate the appropriate header file to locate the appropriate header file to simplify building this module.
to simplify building this module.
.. exception:: error .. exception:: error
@ -246,9 +245,7 @@ to simplify building this module.
.. function:: open(filename[, flag[, mode]]) .. function:: open(filename[, flag[, mode]])
Open a dbm database and return a ``dbm`` object. The *filename* argument is the Open a dbm database and return a ``dbm`` object. The *filename* argument is the
name of the database file (without the :file:`.dir` or :file:`.pag` extensions; name of the database file (without the :file:`.dir` or :file:`.pag` extensions).
note that the BSD DB implementation of the interface will append the extension
:file:`.db` and only create one file).
The optional *flag* argument must be one of these values: The optional *flag* argument must be one of these values: