[ZODB-Dev] Using BerkeleyDB

[Barry Warsaw]

On Mon, 2003-06-02 at 23:51, Richard Jones wrote:
> On Tuesday, June 3, 2003, at 01:30 PM, Barry Warsaw wrote:
> > On Mon, 2003-06-02 at 22:53, Richard Jones wrote:
> >> I noticed that there's descriptions of the BDB configuration 
> >> parameters
> >> in the BDBStorage/* source files - would it be appropriate to copy 
> >> them
> >> over to the ZODB component.xml file? I'd be happy to do it. This info
> >> seems closely related to the DBTab conf.in docs (funny, that ;)
> >
> > Probably, although now we'll have that information in three places (see
> > also BDBStorage/BerkeleyConfig.py).
> 
> Does it belong in the BerkeleyConfig class docstring? 

I think we need to put /something/ in the docstring, since (at least to
me <wink>) that's the most natural place to go looking for it.

> I'll admit it's 
> probably convenient there, but it would make auto-documentation of the 
> schema more difficult. OTOH we could ditch auto-documentation, but then 
> we'd be maintaining another documentation text manually which 
> duplicates the explanations *again*. 

I guess I really don't know what the "auto-documentation of the schema"
is.  My bad.

> Is this an issue with other 
> ZConfig-using components? At first glance, others don't seem to use the 
> same BerkeleyConfig-style pattern.

I really wanted to simplify the Berkeley storage constructors, and I
wanted to make it easily extensible without changing the signature, in
case we wanted to expose more of the underlying BerkeleyDB configuration
options to Python code.

> Also, sorry for being dumb, but where's the third place?

Sorry, I thought it was in Doc/BDBStorage.txt, but it's not.

> This probably isn't a discussion to be had on this list though... 
> probably belongs on zope-coders?

Maybe.  I'm not sure.  Feel free to move the discussion there.
-Barry