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

[SourceForge.net]

Bugs item #998001, was opened at 2004-07-26 12:13
Message generated for change (Tracker Item Submitted) made by Item Submitter
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: Open
Resolution: None
Priority: 5
Submitted By: kim bruning (kimbruning)
Assigned to: Nobody/Anonymous (nobody)
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):


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

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