[issue5942] Ambiguity in dbm.open flag documentation

[Mitchell Model]

Mitchell Model <mlm at acm.org> added the comment:

No, I mean dbm.open. The third paragraph of its documentation says "'c'
to create the database if it doesn’t exist, or 'n', which will always
create a new empty database". This could easily be read as opening the
database just for writing, although come to think of it a write-only
database doesn't make any sense. I guess I was just being
literal/mechanical in my reading of it, trying to make sure it erased
all doubt. If the previous flags hadn't been explicitly documented as
"for reading only" and "for reading and writing" it wouldn't have
occurred to me that 'c' and 'n' should also be documented as reading and
writing. No problem if you think this is too trivial and unlikely a
problem to bother correcting.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue5942>
_______________________________________