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