[ python-Bugs-998001 ] bsddb has default flag of c, not r

[SourceForge.net]

Bugs item #998001, was opened at 2004-07-26 08:13
Message generated for change (Comment added) made by akuchling
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=998001&group_id=5470

Category: Documentation
Group: Python 2.3
>Status: Closed
Resolution: Fixed
Priority: 5
Submitted By: kim bruning (kimbruning)
>Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: bsddb has default flag of c, not r

Initial Comment:
python 2.3.3 has a discrepancy with the documentation
at http://docs.python.org/lib/module-bsddb.htm

In section:
> 7.13 bsddb -- Interface to Berkeley DB library

for hashopen, btopen and rnopen, the documentation
states that:

> The optional flag identifies the mode used to open
the file. It >may be "r" (read only, default)

It turns out that 'r' is in fact not the default option
for any of
these 3 in Python 2.3.3.
The default option for the flag parameter turns out to
be 'c'. I had
some trouble with using the bsddb module in conjunction
with make, and finally resorted to reading the source
code to find out what was wrong.

The actual source code has:

def hashopen(file, flag='c', mode=0666, pgsize=None,
ffactor=None, nelem=None,
            cachesize=None, lorder=None, hflags=0):

def btopen(file, flag='c', mode=0666,
            btflags=0, cachesize=None, maxkeypage=None,
minkeypage=None,
            pgsize=None, lorder=None):

def rnopen(file, flag='c', mode=0666,
            rnflags=0, cachesize=None, pgsize=None,
lorder=None,
            rlen=None, delim=None, source=None, pad=None):


----------------------------------------------------------------------

>Comment By: A.M. Kuchling (akuchling)
Date: 2004-08-03 08:16

Message:
Logged In: YES 
user_id=11375

Marking as closed.

----------------------------------------------------------------------

Comment By: kim bruning (kimbruning)
Date: 2004-07-26 14:00

Message:
Logged In: YES 
user_id=1091452

Fred Drake has fixed this in the documentation source

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=998001&group_id=5470