[Python-checkins] python/dist/src/Doc/lib libbsddb.tex,1.9,1.10

[greg@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv26102

Modified Files:
	libbsddb.tex 
Log Message:
Include a link to the pybsddb web documentation for the modern object
oriented DbEnv & Db object BerkeleyDB interface.

Include a note about Sleepycat's BerkeleyDB license with regards to
distributing it within non-opensource applications and include a link
to their website for license details.

Document that 'r' is the default flag for the legacy bsddb btopen(),
hashopen(), and rnopen() functions.  This is apparently different than the
dbm libraries in other languages according to Bug #732951.  Changing
the default from 'r' to 'c' would break backwards compatibility with
legacy bsddb applications; documenting the default should suffice.


Index: libbsddb.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libbsddb.tex,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** libbsddb.tex	6 May 2003 20:39:55 -0000	1.9
--- libbsddb.tex	28 May 2003 07:56:45 -0000	1.10
***************
*** 15,29 ****
  serialize them somehow, typically using marshal.dumps or pickle.dumps.
  
! There are two incompatible versions of the underlying library.
! Version 1.85 is widely available, but has some known bugs.  Version 2
! is not quite as widely used, but does offer some improvements.  The
! \module{bsddb} module uses the 1.85 interface.  Starting with Python
! 2.0, the \program{configure} script can usually determine the
! version of the library which is available and build it correctly.  If
! you have difficulty getting \program{configure} to do the right thing,
! run it with the \longprogramopt{help} option to get information about
! additional options that can help.  On Windows, you will need to define
! the \code{HAVE_DB_185_H} macro if you are building Python from source
! and using version 2 of the DB library.
  
  The \module{bsddb} module defines the following functions that create
--- 15,40 ----
  serialize them somehow, typically using marshal.dumps or pickle.dumps.
  
! Starting with Python 2.3 the \module{bsddb} module requires the
! Berkeley DB library version 3.1 or later (it is known to work with 3.1
! thru 4.1 at the time of this writing).
! 
! NOTE: BerkeleyDB has its own license which may apply to you if you
! intend to distribute your application outside of your organization in
! a non-opensource manner.  Visit Sleepycat Software's website to read
! the full license.
! 
! \begin{seealso}
!   \seeurl{http://pybsddb.sourceforge.net/}{Website with documentation
!   for the new python Berkeley DB interface that closely mirrors the 
!   sleepycat object oriented interface provided in Berkeley DB 3 and 4.}
!   \seeurl{http://www.sleepycat.com/}{Sleepycat Software produces the
!   modern Berkeley DB library.  They offer support and sell licenses for
!   proprietary software using BerkeleyDB.}
! \end{seealso}
! 
! The following is a description of the legacy \module{bsddb} interface
! compatible with the old python bsddb module.  For details about the more
! modern Db and DbEnv object oriented interface see the above mentioned
! pybsddb URL.
  
  The \module{bsddb} module defines the following functions that create
***************
*** 42,46 ****
  \var{filename}.  The optional
  \var{flag} identifies the mode used to open the file.  It may be
! \character{r} (read only), \character{w} (read-write),
  \character{c} (read-write - create if necessary) or
  \character{n} (read-write - truncate to zero length).  The other
--- 53,57 ----
  \var{filename}.  The optional
  \var{flag} identifies the mode used to open the file.  It may be
! \character{r} (read only, default), \character{w} (read-write) ,
  \character{c} (read-write - create if necessary) or
  \character{n} (read-write - truncate to zero length).  The other
***************
*** 58,62 ****
  \var{filename}.  The optional
  \var{flag} identifies the mode used to open the file.  It may be
! \character{r} (read only), \character{w} (read-write),
  \character{c} (read-write - create if necessary) or
  \character{n} (read-write - truncate to zero length).  The other
--- 69,73 ----
  \var{filename}.  The optional
  \var{flag} identifies the mode used to open the file.  It may be
! \character{r} (read only, default), \character{w} (read-write),
  \character{c} (read-write - create if necessary) or
  \character{n} (read-write - truncate to zero length).  The other
***************
*** 74,78 ****
  \var{filename}.  The optional
  \var{flag} identifies the mode used to open the file.  It may be
! \character{r} (read only), \character{w} (read-write),
  \character{c} (read-write - create if necessary) or
  \character{n} (read-write - truncate to zero length).  The other
--- 85,89 ----
  \var{filename}.  The optional
  \var{flag} identifies the mode used to open the file.  It may be
! \character{r} (read only, default), \character{w} (read-write),
  \character{c} (read-write - create if necessary) or
  \character{n} (read-write - truncate to zero length).  The other