[Python-Dev] 2.3.2 and bsddb

Gregory P. Smith greg at electricrain.com
Wed Oct 1 19:19:18 EDT 2003


On Wed, Oct 01, 2003 at 09:01:03AM -0400, Barry Warsaw wrote:
> On Wed, 2003-10-01 at 02:10, Anthony Baxter wrote:
> > Just another thought - should the newer pybsddb API be folded into the
> > library docs?

+1 all for it (for python 2.4).  the pybsddb docs should be TeX-ified
and included.  They were originally written by Robin using a zope-ish
formatted ascii -> html generator of some sort so automating the bulk
of the task should be possible.

> ... but I would make one change.  I think the
> links to the C API point to pybsddb copies of the Sleepycat
> documentation.  I'd change those to point to Sleepycat's own online
> documentation.  It's more fragile, but 1) it means pulling less into
> Python's library, and 2) should be more up-to-date as Sleepycat makes
> changes and new releases.

+1 agreed.

One caveat:  Sleepycat keeps the documentation for their current release
of BerkeleyDB online at http://www.sleepycat.com/docs/.  It doesn't
mention any of the different behaviours or even API differences between
it and older versions of BerkeleyDB.

We have no way of knowing exactly what version the users python is
compiled against other than in windows binary releases.

Mentioning that caveat in the documentation should be enough.

-g




More information about the Python-Dev mailing list