summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-09-15 15:19:35 (GMT)
committerFred Drake <fdrake@acm.org>2000-09-15 15:19:35 (GMT)
commit6e5184fe6a1d3f09416ee661fb59274d33ae8705 (patch)
treeedddcb5be16567bd2a287c303fc00392c2e03c13 /Doc
parentbe467e5c69515c355982e41d90762a31f2d3f75b (diff)
downloadcpython-6e5184fe6a1d3f09416ee661fb59274d33ae8705.zip
cpython-6e5184fe6a1d3f09416ee661fb59274d33ae8705.tar.gz
cpython-6e5184fe6a1d3f09416ee661fb59274d33ae8705.tar.bz2
Update comments in the second paragraph, discussing versioning issues
related to the BSD DB library. Based on comments from Mark Summerfield <summer@netcraft.com>.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libbsddb.tex17
1 files changed, 9 insertions, 8 deletions
diff --git a/Doc/lib/libbsddb.tex b/Doc/lib/libbsddb.tex
index 6a27a3b..e27aff8 100644
--- a/Doc/lib/libbsddb.tex
+++ b/Doc/lib/libbsddb.tex
@@ -14,16 +14,17 @@ dictionaries. Keys and values must be strings, however, so to use
other objects as keys or to store other kinds of objects the user must
serialize them somehow, typically using marshal.dumps or pickle.dumps.
-The \module{bsddb} module is only available on \UNIX{} systems, so it
-is not built by default in the standard Python distribution. Also,
-there are two incompatible versions of the underlying library.
+There are two incompatible versions of the underlying library.
Version 1.85 is widely available, but has some known bugs. Version 2
is not quite as widely used, but does offer some improvements. The
-\module{bsddb} module uses the 1.85 interface. Users wishing to use
-version 2 of the Berkeley DB library will have to modify the source
-for the module to include \file{db_185.h} instead of
-\file{db.h} (\file{db_185.h} contains the version 1.85 compatibility
-interface).
+\module{bsddb} module uses the 1.85 interface. Starting with Python
+2.0, the \program{configure} script can usually determine the
+version of the library which is available and build it correctly. If
+you have difficulty getting \program{configure} to do the right thing,
+run it with the \longprogramopt{help} option to get information about
+additional options that can help. On Windows, you will need to define
+the \code{HAVE_DB_185_H} macro if you are building Python from source
+and using version 2 of the DB library.
The \module{bsddb} module defines the following functions that create
objects that access the appropriate type of Berkeley DB file. The