[Python-Dev] python/dist/src/Lib/bsddb __init__.py,1.5,1.6

[Martin v. Löwis]

"Raymond Hettinger" <python at rcn.com> writes:

> In this particular case, we are (IMHO) much better off adding an
> iterable interface than leaving current situation with "db.first()"
> and "while 1: db.next()" wrapped in a try/except for an 
> undocumented exception class -- yuck.  

As nobody has protested against this specific change (yet?), I guess
you can go ahead and apply it. In doing so, you have to accept the
burden of taking blame in case this turns out to be a bad idea.

> Worse still, the docs for Py2.3.0 cannot be changed and they are
> wrong on several counts (the methods return items instead of keys;
> EOF is signaled by an exception instead of None; and the example
> doesn't run).

That would be a documentation bug. However, documentation bugs are
generally best fixed by correcting the documentation, not by adjusting
the code to match the documentation (atleast, for maintenance
releases).

Regards,
Martin