Hello,

I thought it could be interesting to write some documentation for the
bdb module, since it keeps undocumented on Python 2.6 and 3.0. The
document I attach is written in reStructuredText, and for using it with
2.5 it only needs to change the header for the 'Bdb.user_exception'
method (and convert to LaTeX format, of course).

It will thank a revision because there can be some grammatical errors
(I'm from Spain). Anyway, I hope it helps, and any comment will be
welcomed :D

I've reviewed the docs for English and general readability. As
mentioned, I've no idea of the tech involved. I did look through the
bdb.py source and the existing docs for pdb to get some idea of the
terminology used. Ultimately I've changed very little; in a couple of
places the English was just wrong and in a couple of others I felt a
small change improved things.

One thing I couldn't work out is that arklad, the author, used "canonic"
throughout which I've never seen used. I would simply have changed it to
"canonical" except that the code itself uses "canonic" as a function
name! In addition, there's no explanation of what canonic(al) means in
the context. I've left ?TJG? marks around all the instances.

Thanks for reviewing, I'll finish and commit that one shortly.

Oops, of course a filename should be in canonical form (an absolute name
which does not contain repeated path separators or symbolic links)!

Okay, committed as rev. 58112, 58113. Thank you!