[Python-Dev] python/dist/src/Lib/bsddb init.py,1.5,1.6 (original) (raw)

Martin v. Löwis martin at v.loewis.de
Sun Sep 14 18:08:57 EDT 2003

"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

More information about the Python-Dev mailing list