DB_File 1.805

From: "Paul Marquess" <Paul.Marquess@btinternet.com>
Message-ID: <AIEAJICLCBDNAAOLLOKLAEMCFFAA.Paul.Marquess@btinternet.com>

p4raw-id: //depot/perl@17836

1 files changed, 260 insertions, 243 deletions

diff --git a/ext/DB_File/Changes b/ext/DB_File/Changes
index 3351542eee..7883cbdfef 100644
--- a/ext/DB_File/Changes
+++ b/ext/DB_File/Changes
@@ -1,208 +1,224 @@
 
-0.1
+1.805 1st September 2002
 
-    First Release.
+   * Added support to allow DB_File to build with Berkeley DB 4.1.X
 
-0.2
+   * Tightened up the test harness to test that calls to untie don't generate
+     the "untie attempted while %d inner references still exist" warning.
 
-    When DB_File is opening a database file it no longer terminates the
-    process if dbopen returned an error. This allows file protection
-    errors to be caught at run time. Thanks to Judith Grass
-    <grass@cybercash.com> for spotting the bug.
+   * added code to guard against calling the callbacks (compare,hash & prefix) 
+     recursively.
 
-0.3
+   * pasing undef for the flags and/or mode when opening a database could cause
+     a "Use of uninitialized value in subroutine entry" warning. Now silenced.
 
-    Added prototype support for multiple btree compare callbacks.
+   * DBM filter code beefed up to cope with read-only $_.
 
-1.0
+1.804 2nd June 2002
 
-    DB_File has been in use for over a year. To reflect that, the
-    version number has been incremented to 1.0.
+   * Perl core patch 14939 added a new warning to "splice". This broke the
+     db-recno test harness. Fixed.
 
-    Added complete support for multiple concurrent callbacks.
+   * merged core patches 16502 & 16540.
 
-    Using the push method on an empty list didn't work properly. This
-    has been fixed.
+1.803 1st March 2002
 
-1.01
+   * Fixed a problem with db-btree.t where it complained about an "our"
+     variable redeclaation.
 
-    Fixed a core dump problem with SunOS.
+   * FETCH, STORE & DELETE don't map the flags parameter into the
+     equivalent Berkeley DB function anymore.
 
-    The return value from TIEHASH wasn't set to NULL when dbopen
-    returned an error.
+1.802 6th January 2002
 
-1.02
+   * The message about some test failing in db-recno.t had the wrong test
+     numbers. Fixed.
 
-    Merged OS/2 specific code into DB_File.xs
+   * merged core patch 13942.
 
-    Removed some redundant code in DB_File.xs.
+1.801 26th November 2001
 
-    Documentation update.
+   * Fixed typo in Makefile.PL
 
-    Allow negative subscripts with RECNO interface.
+   * Added "clean" attribute to Makefile.PL
+ 
+1.800 23rd November 2001
 
-    Changed the default flags from O_RDWR to O_CREAT|O_RDWR.
+   * use pport.h for perl backward compatability code.
 
-    The example code which showed how to lock a database needed a call
-    to sync added. Without it the resultant database file was empty.
+   * use new  ExtUtils::Constant module to generate XS constants.
 
-    Added get_dup method.
+   * upgrade Makefile.PL upgrade/downgrade code to toggle "our" with
+     "use vars"
 
-1.03
+1.79 22nd October 2001
 
-    Documentation update.
+   * Added a "local $SIG{__DIE__}" inside the eval that checks for
+     the presence of XSLoader s suggested by Andrew Hryckowin.
 
-    DB_File now imports the constants (O_RDWR, O_CREAT etc.) from Fcntl
-    automatically.
+   * merged core patch 12277.
 
-    The standard hash function exists is now supported.
+   * Changed NEXTKEY to not initialise the input key. It isn't used anyway.
 
-    Modified the behavior of get_dup. When it returns an associative
-    array, the value is the count of the number of matching BTREE
-    values.
+1.79 22nd October 2001
 
-1.04
+   * Fixed test harness for cygwin
 
-    Minor documentation changes.
+1.78 30th July 2001
 
-    Fixed a bug in hash_cb. Patches supplied by Dave Hammen,
-    <hammen@gothamcity.jsc.nasa.govt>.
+   * the test in Makefile.PL for AIX used -plthreads. Should have been
+     -lpthreads
 
-    Fixed a bug with the constructors for DB_File::HASHINFO,
-    DB_File::BTREEINFO and DB_File::RECNOINFO. Also tidied up the
-    constructors to make them -w clean.
+   * merged Core patches 
+        10372, 10335, 10372, 10534, 10549, 10643, 11051, 11194, 11432
 
-    Reworked part of the test harness to be more locale friendly.
+   * added documentation patch regarding duplicate keys from Andrew Johnson
 
-1.05
 
-    Made all scripts in the documentation strict and -w clean.
+1.77 26th April 2001
 
-    Added logic to DB_File.xs to allow the module to be built after
-    Perl is installed.
+   * AIX is reported to need -lpthreads, so Makefile.PL now checks for
+     AIX and adds it to the link options.
 
-1.06
+   * Minor documentation updates.
 
-    Minor namespace cleanup: Localized PrintBtree.
+   * Merged Core patch 9176
 
-1.07
+   * Added a patch from Edward Avis that adds support for splice with
+     recno databases.
 
-    Fixed bug with RECNO, where bval wasn't defaulting to "\n".
+   * Modified Makefile.PL to only enable the warnings pragma if using perl
+     5.6.1 or better.    
 
-1.08
+1.76 15th January 2001
 
-    Documented operation of bval.
+   * Added instructions for using LD_PRELOAD to get Berkeley DB 2.x to work
+     with DB_File on Linux. Thanks to Norbert Bollow for sending details of
+     this approach.
 
-1.09
 
-    Minor bug fix in DB_File::HASHINFO, DB_File::RECNOINFO and
-    DB_File::BTREEINFO.
+1.75 17th December 2000
 
-    Changed default mode to 0666.
+   * Fixed perl core patch 7703
 
-1.10
+   * Added suppport to allow DB_File to be built with Berkeley DB 3.2 --
+     btree_compare, btree_prefix and hash_cb needed to be changed.
 
-    Fixed fd method so that it still returns -1 for in-memory files
-    when db 1.86 is used.
+   * Updated dbinfo to support Berkeley DB 3.2 file format changes.
 
-1.11
 
-    Documented the untie gotcha.
+1.74 10th December 2000
 
-1.12
+   * A "close" call in DB_File.xs needed parenthesised to stop win32 from
+     thinking it was one of its macros.
 
-    Documented the incompatibility with version 2 of Berkeley DB.
+   * Updated dbinfo to support Berkeley DB 3.1 file format changes.
 
-1.13
+   * DB_File.pm & the test hasness now use the warnings pragma (when
+     available).
 
-    Minor changes to DB_FIle.xs and DB_File.pm
+   * Included Perl core patch 7703 -- size argument for hash_cb is different
+     for Berkeley DB 3.x
 
-1.14
+   * Included Perl core patch 7801 -- Give __getBerkeleyDBInfo the ANSI C
+     treatment.
 
-    Made it illegal to tie an associative array to a RECNO database and
-    an ordinary array to a HASH or BTREE database.
+   * @a = () produced the warning 'Argument "" isn't numeric in entersub'
+     This has been fixed. Thanks to Edward Avis for spotting this bug.
 
-1.15
+   * Added note about building under Linux. Included patches.
 
-    Patch from Gisle Aas <gisle@aas.no> to suppress "use of undefined
-    value" warning with db_get and db_seq.
+   * Included Perl core patch 8068 -- fix for bug 20001013.009 
+     When run with warnings enabled "$hash{XX} = undef " produced an
+     "Uninitialized value" warning. This has been fixed.
 
-    Patch from Gisle Aas <gisle@aas.no> to make DB_File export only the
-    O_* constants from Fcntl.
+1.73 31st May 2000
 
-    Removed the DESTROY method from the DB_File::HASHINFO module.
+   * Added support in version.c for building with threaded Perl.
 
-    Previously DB_File hard-wired the class name of any object that it
-    created to "DB_File". This makes sub-classing difficult. Now
-    DB_File creats objects in the namespace of the package it has been
-    inherited into.
+   * Berkeley DB 3.1 has reenabled support for null keys. The test
+     harness has been updated to reflect this.
 
+1.72 16th January 2000
 
-1.16
+   * Added hints/sco.pl
 
-   A harmless looking tab was causing Makefile.PL to fail on AIX 3.2.5
+   * The module will now use XSLoader when it is available. When it
+     isn't it will use DynaLoader.
 
-    Small fix for the AIX strict C compiler XLC which doesn't like
-    __attribute__ being defined via proto.h and redefined via db.h. Fix
-    courtesy of Jarkko Hietaniemi.
+   * The locking section in DB_File.pm has been discredited. Many thanks
+     to David Harris for spotting the underlying problem, contributing
+     the updates to the documentation and writing DB_File::Lock (available
+     on CPAN).
 
-1.50
+1.71 7th September 1999
 
-    DB_File can now build with either DB 1.x or 2.x, but not both at
-    the same time.
+   * Fixed a bug that prevented 1.70 from compiling under win32
 
-1.51
+   * Updated to support Berkeley DB 3.x
 
-    Fixed the test harness so that it doesn't expect DB_File to have
-    been installed by the main Perl build.
+   * Updated dbinfo for Berkeley DB 3.x file formats.
 
+1.70 4th August 1999
 
-    Fixed a bug in mapping 1.x O_RDONLY flag to 2.x DB_RDONLY equivalent
+   * Initialise $DB_File::db_ver and $DB_File::db_version with
+     GV_ADD|GV_ADDMULT -- bug spotted by Nick Ing-Simmons.
 
-1.52
+   * Added a BOOT check to test for equivalent versions of db.h &
+     libdb.a/so.
 
-   Patch from Nick Ing-Simmons now allows DB_File to build on NT.
-   Merged 1.15 patch.
+1.69 3rd August 1999
 
-1.53
+   * fixed a bug in push -- DB_APPEND wasn't working properly.
 
-   Added DB_RENUMBER to flags for recno.
+   * Fixed the R_SETCURSOR bug introduced in 1.68
 
-1.54
+   * Added a new Perl variable $DB_File::db_ver
+   
+1.68 22nd July 1999
 
-   Fixed a small bug in the test harness when run under win32
-   The emulation of fd when useing DB 2.x was busted.
+   * Merged changes from 5.005_58 
 
-1.55
-   Merged 1.16 changes.
+   * Fixed a bug in R_IBEFORE & R_IAFTER procesing in Berkeley DB
+     2 databases.
 
-1.56
-   Documented the Solaris 2.5 mutex bug
+   * Added some of the examples in the POD into the test harness.
 
-1.57
-   If Perl has been compiled with Threads support,the symbol op will be
-   defined. This clashes with a field name in db.h, so it needs to be
-   #undef'ed before db.h is included.
+1.67 6th June 1999
 
-1.58
-   Tied Array support was enhanced in Perl 5.004_57. DB_File now
-   supports PUSH,POP,SHIFT,UNSHIFT & STORESIZE.
+   * Added DBM Filter documentation to DB_File.pm
 
-   Fixed a problem with the use of sv_setpvn. When the size is
-   specified as 0, it does a strlen on the data.  This was ok for DB
-   1.x, but isn't for DB 2.x.
+   * Fixed DBM Filter code to work with 5.004
 
-1.59
-   Updated the license section.
+   * A few instances of newSVpvn were used in 1.66. This isn't available in
+     Perl 5.004_04 or earlier. Replaced with newSVpv.
 
-   Berkeley DB 2.4.10 disallows zero length keys. Tests 32 & 42 in
-   db-btree.t and test 27 in db-hash.t failed because of this change.
-   Those tests have been zapped.
+1.66 15th March 1999
 
-   Added dbinfo to the distribution.
+   * Added DBM Filter code
 
-1.60
-   Changed the test to check for full tied array support
+1.65 6th March 1999
+
+   * Fixed a bug in the recno PUSH logic.
+   * The BOOT version check now needs 2.3.4 when using Berkeley DB version 2
+
+1.64 21st February 1999
+
+   * Tidied the 1.x to 2.x flag mapping code.
+   * Added a patch from Mark Kettenis <kettenis@wins.uva.nl> to fix a flag
+     mapping problem with O_RDONLY on the Hurd
+   * Updated the message that db-recno.t prints when tests 51, 53 or 55 fail.
+
+1.63 19th December 1998
+
+   * Fix to allow DB 2.6.x to build with DB_File
+   * Documentation updated to use push,pop etc in the RECNO example &
+     to include the find_dup & del_dup methods.
+
+1.62 30th November 1998
+
+   Added hints/dynixptx.pl.
+   Fixed typemap -- 1.61 used PL_na instead of na
 
 1.61 19th November 1998
 
@@ -211,207 +227,208 @@
    Minor modifications to get the module to build with DB 2.5.x
    Fixed a typo in the definition of O_RDONLY, courtesy of Mark Kettenis.
 
-1.62 30th November 1998
+1.60
+   Changed the test to check for full tied array support
 
-   Added hints/dynixptx.pl.
-   Fixed typemap -- 1.61 used PL_na instead of na
+1.59
+   Updated the license section.
 
-1.63 19th December 1998
+   Berkeley DB 2.4.10 disallows zero length keys. Tests 32 & 42 in
+   db-btree.t and test 27 in db-hash.t failed because of this change.
+   Those tests have been zapped.
 
-   * Fix to allow DB 2.6.x to build with DB_File
-   * Documentation updated to use push,pop etc in the RECNO example &
-     to include the find_dup & del_dup methods.
+   Added dbinfo to the distribution.
 
-1.64 21st February 1999
+1.58
+   Tied Array support was enhanced in Perl 5.004_57. DB_File now
+   supports PUSH,POP,SHIFT,UNSHIFT & STORESIZE.
 
-   * Tidied the 1.x to 2.x flag mapping code.
-   * Added a patch from Mark Kettenis <kettenis@wins.uva.nl> to fix a flag
-     mapping problem with O_RDONLY on the Hurd
-   * Updated the message that db-recno.t prints when tests 51, 53 or 55 fail.
+   Fixed a problem with the use of sv_setpvn. When the size is
+   specified as 0, it does a strlen on the data.  This was ok for DB
+   1.x, but isn't for DB 2.x.
 
-1.65 6th March 1999
+1.57
+   If Perl has been compiled with Threads support,the symbol op will be
+   defined. This clashes with a field name in db.h, so it needs to be
+   #undef'ed before db.h is included.
 
-   * Fixed a bug in the recno PUSH logic.
-   * The BOOT version check now needs 2.3.4 when using Berkeley DB version 2
+1.56
+   Documented the Solaris 2.5 mutex bug
 
-1.66 15th March 1999
+1.55
+   Merged 1.16 changes.
 
-   * Added DBM Filter code
+1.54
 
-1.67 6th June 1999
+   Fixed a small bug in the test harness when run under win32
+   The emulation of fd when useing DB 2.x was busted.
 
-   * Added DBM Filter documentation to DB_File.pm
+1.53
 
-   * Fixed DBM Filter code to work with 5.004
+   Added DB_RENUMBER to flags for recno.
 
-   * A few instances of newSVpvn were used in 1.66. This isn't available in
-     Perl 5.004_04 or earlier. Replaced with newSVpv.
+1.52
 
-1.68 22nd July 1999
+   Patch from Nick Ing-Simmons now allows DB_File to build on NT.
+   Merged 1.15 patch.
 
-   * Merged changes from 5.005_58 
+1.51
 
-   * Fixed a bug in R_IBEFORE & R_IAFTER procesing in Berkeley DB
-     2 databases.
+    Fixed the test harness so that it doesn't expect DB_File to have
+    been installed by the main Perl build.
 
-   * Added some of the examples in the POD into the test harness.
 
-1.69 3rd August 1999
+    Fixed a bug in mapping 1.x O_RDONLY flag to 2.x DB_RDONLY equivalent
 
-   * fixed a bug in push -- DB_APPEND wasn't working properly.
+1.50
 
-   * Fixed the R_SETCURSOR bug introduced in 1.68
+    DB_File can now build with either DB 1.x or 2.x, but not both at
+    the same time.
 
-   * Added a new Perl variable $DB_File::db_ver
-   
-1.70 4th August 1999
+1.16
 
-   * Initialise $DB_File::db_ver and $DB_File::db_version with
-     GV_ADD|GV_ADDMULT -- bug spotted by Nick Ing-Simmons.
+   A harmless looking tab was causing Makefile.PL to fail on AIX 3.2.5
 
-   * Added a BOOT check to test for equivalent versions of db.h &
-     libdb.a/so.
+    Small fix for the AIX strict C compiler XLC which doesn't like
+    __attribute__ being defined via proto.h and redefined via db.h. Fix
+    courtesy of Jarkko Hietaniemi.
 
-1.71 7th September 1999
+1.15
 
-   * Fixed a bug that prevented 1.70 from compiling under win32
+    Patch from Gisle Aas <gisle@aas.no> to suppress "use of undefined
+    value" warning with db_get and db_seq.
 
-   * Updated to support Berkeley DB 3.x
+    Patch from Gisle Aas <gisle@aas.no> to make DB_File export only the
+    O_* constants from Fcntl.
 
-   * Updated dbinfo for Berkeley DB 3.x file formats.
+    Removed the DESTROY method from the DB_File::HASHINFO module.
 
-1.72 16th January 2000
+    Previously DB_File hard-wired the class name of any object that it
+    created to "DB_File". This makes sub-classing difficult. Now
+    DB_File creats objects in the namespace of the package it has been
+    inherited into.
 
-   * Added hints/sco.pl
 
-   * The module will now use XSLoader when it is available. When it
-     isn't it will use DynaLoader.
+1.14
 
-   * The locking section in DB_File.pm has been discredited. Many thanks
-     to David Harris for spotting the underlying problem, contributing
-     the updates to the documentation and writing DB_File::Lock (available
-     on CPAN).
+    Made it illegal to tie an associative array to a RECNO database and
+    an ordinary array to a HASH or BTREE database.
 
-1.73 31st May 2000
+1.13
 
-   * Added support in version.c for building with threaded Perl.
+    Minor changes to DB_FIle.xs and DB_File.pm
 
-   * Berkeley DB 3.1 has reenabled support for null keys. The test
-     harness has been updated to reflect this.
+1.12
 
-1.74 10th December 2000
+    Documented the incompatibility with version 2 of Berkeley DB.
 
-   * A "close" call in DB_File.xs needed parenthesised to stop win32 from
-     thinking it was one of its macros.
+1.11
 
-   * Updated dbinfo to support Berkeley DB 3.1 file format changes.
+    Documented the untie gotcha.
 
-   * DB_File.pm & the test hasness now use the warnings pragma (when
-     available).
+1.10
 
-   * Included Perl core patch 7703 -- size argument for hash_cb is different
-     for Berkeley DB 3.x
+    Fixed fd method so that it still returns -1 for in-memory files
+    when db 1.86 is used.
 
-   * Included Perl core patch 7801 -- Give __getBerkeleyDBInfo the ANSI C
-     treatment.
+1.09
 
-   * @a = () produced the warning 'Argument "" isn't numeric in entersub'
-     This has been fixed. Thanks to Edward Avis for spotting this bug.
+    Minor bug fix in DB_File::HASHINFO, DB_File::RECNOINFO and
+    DB_File::BTREEINFO.
 
-   * Added note about building under Linux. Included patches.
+    Changed default mode to 0666.
 
-   * Included Perl core patch 8068 -- fix for bug 20001013.009 
-     When run with warnings enabled "$hash{XX} = undef " produced an
-     "Uninitialized value" warning. This has been fixed.
+1.08
 
-1.75 17th December 2000
+    Documented operation of bval.
 
-   * Fixed perl core patch 7703
+1.07
 
-   * Added suppport to allow DB_File to be built with Berkeley DB 3.2 --
-     btree_compare, btree_prefix and hash_cb needed to be changed.
+    Fixed bug with RECNO, where bval wasn't defaulting to "\n".
 
-   * Updated dbinfo to support Berkeley DB 3.2 file format changes.
+1.06
 
+    Minor namespace cleanup: Localized PrintBtree.
 
-1.76 15th January 2001
+1.05
 
-   * Added instructions for using LD_PRELOAD to get Berkeley DB 2.x to work
-     with DB_File on Linux. Thanks to Norbert Bollow for sending details of
-     this approach.
+    Made all scripts in the documentation strict and -w clean.
 
+    Added logic to DB_File.xs to allow the module to be built after
+    Perl is installed.
 
-1.77 26th April 2001
+1.04
 
-   * AIX is reported to need -lpthreads, so Makefile.PL now checks for
-     AIX and adds it to the link options.
+    Minor documentation changes.
 
-   * Minor documentation updates.
+    Fixed a bug in hash_cb. Patches supplied by Dave Hammen,
+    <hammen@gothamcity.jsc.nasa.govt>.
 
-   * Merged Core patch 9176
+    Fixed a bug with the constructors for DB_File::HASHINFO,
+    DB_File::BTREEINFO and DB_File::RECNOINFO. Also tidied up the
+    constructors to make them -w clean.
 
-   * Added a patch from Edward Avis that adds support for splice with
-     recno databases.
+    Reworked part of the test harness to be more locale friendly.
 
-   * Modified Makefile.PL to only enable the warnings pragma if using perl
-     5.6.1 or better.    
+1.03
 
-1.78 30th July 2001
+    Documentation update.
 
-   * the test in Makefile.PL for AIX used -plthreads. Should have been
-     -lpthreads
+    DB_File now imports the constants (O_RDWR, O_CREAT etc.) from Fcntl
+    automatically.
 
-   * merged Core patches 
-        10372, 10335, 10372, 10534, 10549, 10643, 11051, 11194, 11432
+    The standard hash function exists is now supported.
 
-   * added documentation patch regarding duplicate keys from Andrew Johnson
+    Modified the behavior of get_dup. When it returns an associative
+    array, the value is the count of the number of matching BTREE
+    values.
 
-1.79 22nd October 2001
+1.02
 
-   * Added a "local $SIG{__DIE__}" inside the eval that checks for
-     the presence of XSLoader s suggested by Andrew Hryckowin.
+    Merged OS/2 specific code into DB_File.xs
 
-   * merged core patch 12277.
+    Removed some redundant code in DB_File.xs.
 
-   * Changed NEXTKEY to not initialise the input key. It isn't used anyway.
+    Documentation update.
 
-1.79 22nd October 2001
+    Allow negative subscripts with RECNO interface.
 
-   * Fixed test harness for cygwin
+    Changed the default flags from O_RDWR to O_CREAT|O_RDWR.
 
+    The example code which showed how to lock a database needed a call
+    to sync added. Without it the resultant database file was empty.
 
-1.800 23rd November 2001
+    Added get_dup method.
 
-   * use pport.h for perl backward compatability code.
+1.01
 
-   * use new  ExtUtils::Constant module to generate XS constants.
+    Fixed a core dump problem with SunOS.
 
-   * upgrade Makefile.PL upgrade/downgrade code to toggle "our" with
-     "use vars"
+    The return value from TIEHASH wasn't set to NULL when dbopen
+    returned an error.
 
-1.801 26th November 2001
+1.0
 
-   * Fixed typo in Makefile.PL
+    DB_File has been in use for over a year. To reflect that, the
+    version number has been incremented to 1.0.
 
-   * Added "clean" attribute to Makefile.PL
- 
-1.802 6th January 2002
+    Added complete support for multiple concurrent callbacks.
 
-   * The message about some test failing in db-recno.t had the wrong test
-     numbers. Fixed.
+    Using the push method on an empty list didn't work properly. This
+    has been fixed.
 
-   * merged core patch 13942.
+0.3
 
-1.803 1st March 2002
+    Added prototype support for multiple btree compare callbacks.
 
-   * Fixed a problem with db-btree.t where it complained about an "our"
-     variable redeclaation.
+0.2
 
-   * FETCH, STORE & DELETE don't map the flags parameter into the
-     equivalent Berkeley DB function anymore.
+    When DB_File is opening a database file it no longer terminates the
+    process if dbopen returned an error. This allows file protection
+    errors to be caught at run time. Thanks to Judith Grass
+    <grass@cybercash.com> for spotting the bug.
 
-1.804 2nd March 2002
+0.1
 
-   * Perl core patch 14939 added a new warning to "splice". This broke the
-     db-recno test harness. Fixed.
+    First Release.