diff -Nru libdbm-deep-perl-2.0010/Changes libdbm-deep-perl-2.0011/Changes --- libdbm-deep-perl-2.0010/Changes 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/Changes 2014-01-13 02:05:20.000000000 +0000 @@ -1,5 +1,8 @@ Revision history for DBM::Deep (ordered by revision number). +2.0011 Jan 12 16:00:00 2013 PDT + - POD fixes by H. Merijn Brandt (The X<> tag - Thanks!) + 2.0009 Jun 30 13:00:00 2013 PDT - Can push undefined values onto arrays. diff -Nru libdbm-deep-perl-2.0010/META.json libdbm-deep-perl-2.0011/META.json --- libdbm-deep-perl-2.0010/META.json 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/META.json 2014-01-13 02:05:20.000000000 +0000 @@ -1,10 +1,8 @@ { "abstract" : "A pure perl multi-level hash/array DBM that supports transactions", - "author" : [ - "unknown" - ], + "author" : [], "dynamic_config" : 1, - "generated_by" : "Module::Build version 0.4005, CPAN::Meta::Converter version 2.131560", + "generated_by" : "Module::Build version 0.4203", "license" : [ "perl_5" ], @@ -32,7 +30,7 @@ }, "configure" : { "requires" : { - "Module::Build" : "0.40" + "Module::Build" : "0.42" } }, "runtime" : { @@ -47,7 +45,7 @@ "provides" : { "DBM::Deep" : { "file" : "lib/DBM/Deep.pm", - "version" : "2.0010" + "version" : "2.0011" }, "DBM::Deep::Array" : { "file" : "lib/DBM/Deep/Array.pm" @@ -134,5 +132,5 @@ "url" : "https://github.com/robkinyon/dbm-deep" } }, - "version" : "2.0010" + "version" : "2.0011" } diff -Nru libdbm-deep-perl-2.0010/META.yml libdbm-deep-perl-2.0011/META.yml --- libdbm-deep-perl-2.0010/META.yml 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/META.yml 2014-01-13 02:05:20.000000000 +0000 @@ -11,9 +11,9 @@ Test::More: 0.88 Test::Warn: 0.08 configure_requires: - Module::Build: 0.40 + Module::Build: 0.42 dynamic_config: 1 -generated_by: 'Module::Build version 0.4005, CPAN::Meta::Converter version 2.131560' +generated_by: 'Module::Build version 0.4203, CPAN::Meta::Converter version 2.120351' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html @@ -25,57 +25,82 @@ provides: DBM::Deep: file: lib/DBM/Deep.pm - version: 2.0010 + version: 2.0011 DBM::Deep::Array: file: lib/DBM/Deep/Array.pm + version: 0 DBM::Deep::Engine: file: lib/DBM/Deep/Engine.pm + version: 0 DBM::Deep::Engine::DBI: file: lib/DBM/Deep/Engine/DBI.pm + version: 0 DBM::Deep::Engine::File: file: lib/DBM/Deep/Engine/File.pm + version: 0 DBM::Deep::Hash: file: lib/DBM/Deep/Hash.pm + version: 0 DBM::Deep::Iterator: file: lib/DBM/Deep/Iterator.pm + version: 0 DBM::Deep::Iterator::DBI: file: lib/DBM/Deep/Iterator/DBI.pm + version: 0 DBM::Deep::Iterator::File: file: lib/DBM/Deep/Iterator/File.pm + version: 0 DBM::Deep::Iterator::File::BucketList: file: lib/DBM/Deep/Iterator/File/BucketList.pm + version: 0 DBM::Deep::Iterator::File::Index: file: lib/DBM/Deep/Iterator/File/Index.pm + version: 0 DBM::Deep::Null: file: lib/DBM/Deep/Null.pm + version: 0 DBM::Deep::Sector: file: lib/DBM/Deep/Sector.pm + version: 0 DBM::Deep::Sector::DBI: file: lib/DBM/Deep/Sector/DBI.pm + version: 0 DBM::Deep::Sector::DBI::Reference: file: lib/DBM/Deep/Sector/DBI/Reference.pm + version: 0 DBM::Deep::Sector::DBI::Scalar: file: lib/DBM/Deep/Sector/DBI/Scalar.pm + version: 0 DBM::Deep::Sector::File: file: lib/DBM/Deep/Sector/File.pm + version: 0 DBM::Deep::Sector::File::BucketList: file: lib/DBM/Deep/Sector/File/BucketList.pm + version: 0 DBM::Deep::Sector::File::Data: file: lib/DBM/Deep/Sector/File/Data.pm + version: 0 DBM::Deep::Sector::File::Index: file: lib/DBM/Deep/Sector/File/Index.pm + version: 0 DBM::Deep::Sector::File::Null: file: lib/DBM/Deep/Sector/File/Null.pm + version: 0 DBM::Deep::Sector::File::Reference: file: lib/DBM/Deep/Sector/File/Reference.pm + version: 0 DBM::Deep::Sector::File::Scalar: file: lib/DBM/Deep/Sector/File/Scalar.pm + version: 0 DBM::Deep::Storage: file: lib/DBM/Deep/Storage.pm + version: 0 DBM::Deep::Storage::DBI: file: lib/DBM/Deep/Storage/DBI.pm + version: 0 DBM::Deep::Storage::File: file: lib/DBM/Deep/Storage/File.pm + version: 0 requires: Digest::MD5: 1.00 Fcntl: 0.01 @@ -84,4 +109,4 @@ resources: license: http://dev.perl.org/licenses/ repository: https://github.com/robkinyon/dbm-deep -version: 2.0010 +version: 2.0011 diff -Nru libdbm-deep-perl-2.0010/Makefile.PL libdbm-deep-perl-2.0011/Makefile.PL --- libdbm-deep-perl-2.0010/Makefile.PL 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/Makefile.PL 2014-01-13 02:05:20.000000000 +0000 @@ -1,4 +1,4 @@ -# Note: this file was auto-generated by Module::Build::Compat version 0.4005 +# Note: this file was auto-generated by Module::Build::Compat version 0.4203 require 5.008_004; use ExtUtils::MakeMaker; WriteMakefile diff -Nru libdbm-deep-perl-2.0010/README libdbm-deep-perl-2.0011/README --- libdbm-deep-perl-2.0010/README 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/README 2014-01-13 02:05:20.000000000 +0000 @@ -3,7 +3,7 @@ transactions VERSION - 2.0010 + 2.0011 SYNOPSIS use DBM::Deep; @@ -160,7 +160,7 @@ This opens a new database handle, mapped to the file "foo.db". If this file does not exist, it will automatically be created. DB files are opened in "r+" (read/write) mode, and the type of object returned is a - hash, unless otherwise specified (see "OPTIONS" below). + hash, unless otherwise specified (see "Options" below). You can pass a number of options to the constructor to specify things like locking, autoflush, etc. This is done by passing an inline hash (or @@ -175,7 +175,7 @@ Notice that the filename is now specified *inside* the hash with the "file" parameter, as opposed to being the sole argument to the constructor. This is required if any options are specified. See - "OPTIONS" below for the complete list. + "Options" below for the complete list. You can also start with an array instead of a hash. For this, you must specify the "type" parameter: @@ -204,7 +204,7 @@ my $db = tie @array, "DBM::Deep", "bar.db"; As with the OO constructor, you can replace the DB filename parameter - with a hash containing one or more options (see "OPTIONS" just below for + with a hash containing one or more options (see "Options" just below for the complete list). tie %hash, "DBM::Deep", { @@ -354,7 +354,7 @@ arrays, you can treat them as such (but see "external_refs", above, and "Stale References", below). DBM::Deep will intercept all reads/writes and direct them to the right place -- the DB file. This has nothing to - do with the "TIE CONSTRUCTION" section above. This simply tells you how + do with the "Tie Construction" section above. This simply tells you how to use DBM::Deep using regular hashes and arrays, rather than calling functions like "get()" and "put()" (although those work too). It is entirely up to you how to want to access your databases. @@ -604,7 +604,7 @@ Fetches the first element in the array, deletes it, then shifts all the remaining elements over to take up the space. Returns the element value. This method is not recommended with large arrays -- - see "LARGE ARRAYS" below for details. + see "Large Arrays" below for details. my $elem = $db->shift(); @@ -613,7 +613,7 @@ Inserts one or more elements onto the beginning of the array, shifting all existing elements over to make room. Accepts scalars, hash refs or array refs. No return value. This method is not - recommended with large arrays -- see below for + recommended with large arrays -- see below for details. $db->unshift("foo", "bar", {}); @@ -621,9 +621,9 @@ * splice() Performs exactly like Perl's built-in function of the same name. See - "perldoc -f splice" for usage -- it is too complicated to document - here. This method is not recommended with large arrays -- see "LARGE - ARRAYS" below for details. + "splice" in perlfunc for usage -- it is too complicated to document + here. This method is not recommended with large arrays -- see "Large + Arrays" below for details. Here are some examples of using arrays: @@ -663,7 +663,7 @@ exclusive mode for writes, and shared mode for reads. This is required if you have multiple processes accessing the same database file, to avoid file corruption. Please note that "flock()" does NOT work for - files over NFS. See "DB OVER NFS" below for more. + files over NFS. See "DB over NFS" below for more. Explicit Locking You can explicitly lock a database, so it remains locked for multiple @@ -984,9 +984,9 @@ This section describes all the known issues with DBM::Deep. These are issues that are either intractable or depend on some feature within Perl working exactly right. It you have found something that is not listed - below, please send an e-mail to bug-DBM-Deep@rt.cpan.org. Likewise, if - you think you know of a way around one of these issues, please let me - know. + below, please send an e-mail to bug-DBM-Deep@rt.cpan.org + . Likewise, if you think you know of a + way around one of these issues, please let me know. References (The following assumes a high level of Perl understanding, specifically @@ -1184,14 +1184,16 @@ MORE INFORMATION Check out the DBM::Deep Google Group at or send email to - DBM-Deep@googlegroups.com. You can also visit #dbm-deep on irc.perl.org + DBM-Deep@googlegroups.com . You can + also visit #dbm-deep on irc.perl.org The source code repository is at MAINTAINERS - Rob Kinyon, rkinyon@cpan.org + Rob Kinyon, rkinyon@cpan.org Originally written by Joseph Huckaby, jhuckaby@cpan.org + SPONSORS Stonehenge Consulting () sponsored the @@ -1213,13 +1215,15 @@ * David Steinbrunner for fixing typos and adding repository cpan metadata + * H. Merijn Brandt for fixing the POD escapes. + SEE ALSO DBM::Deep::Cookbook(3) perltie(1), Tie::Hash(3), Fcntl(3), flock(2), lockf(3), nfs(5) LICENSE - Copyright (c) 2007 Rob Kinyon. All Rights Reserved. This is free + Copyright (c) 2007-14 Rob Kinyon. All Rights Reserved. This is free software, you may use it and distribute it under the same terms as Perl itself. diff -Nru libdbm-deep-perl-2.0010/debian/changelog libdbm-deep-perl-2.0011/debian/changelog --- libdbm-deep-perl-2.0010/debian/changelog 2013-12-11 20:15:18.000000000 +0000 +++ libdbm-deep-perl-2.0011/debian/changelog 2014-01-14 18:44:56.000000000 +0000 @@ -1,3 +1,11 @@ +libdbm-deep-perl (2.0011-1) unstable; urgency=medium + + * New upstream release. + * Update years of upstream and packaging copyright. + * Update build dependencies. + + -- gregor herrmann Tue, 14 Jan 2014 19:44:52 +0100 + libdbm-deep-perl (2.0010-1) unstable; urgency=medium * New upstream release. diff -Nru libdbm-deep-perl-2.0010/debian/control libdbm-deep-perl-2.0011/debian/control --- libdbm-deep-perl-2.0010/debian/control 2013-12-11 20:15:18.000000000 +0000 +++ libdbm-deep-perl-2.0011/debian/control 2014-01-14 18:44:56.000000000 +0000 @@ -7,7 +7,7 @@ Section: perl Priority: optional Build-Depends: debhelper (>= 8), - perl (>= 5.17.1) | libmodule-build-perl (>= 0.400000) + libmodule-build-perl (>= 0.420000) | perl (>= 5.19.6) Build-Depends-Indep: perl, libdbd-sqlite3-perl, libdbi-perl, diff -Nru libdbm-deep-perl-2.0010/debian/copyright libdbm-deep-perl-2.0011/debian/copyright --- libdbm-deep-perl-2.0010/debian/copyright 2013-12-11 20:15:18.000000000 +0000 +++ libdbm-deep-perl-2.0011/debian/copyright 2014-01-14 18:44:56.000000000 +0000 @@ -4,13 +4,13 @@ Source: https://metacpan.org/release/DBM-Deep/ Files: * -Copyright: 2007, Rob Kinyon +Copyright: 2007-2014, Rob Kinyon 2002-2006, Joseph Huckaby License: Artistic or GPL-1+ Files: debian/* Copyright: 2008, AGOSTINI Yves - 2010-2013, gregor herrmann + 2010-2014, gregor herrmann 2012, Nathan Handler License: Artistic or GPL-1+ diff -Nru libdbm-deep-perl-2.0010/lib/DBM/Deep/Storage/DBI.pm libdbm-deep-perl-2.0011/lib/DBM/Deep/Storage/DBI.pm --- libdbm-deep-perl-2.0010/lib/DBM/Deep/Storage/DBI.pm 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/lib/DBM/Deep/Storage/DBI.pm 2014-01-13 02:05:20.000000000 +0000 @@ -159,12 +159,9 @@ sub rand_function { my $self = shift; my $driver = $self->driver; - if ( $driver eq 'sqlite' ) { - return 'random()'; - } - elsif ( $driver eq 'mysql' ) { - return 'RAND()'; - } + + $driver eq 'sqlite' and return 'random()'; + $driver eq 'mysql' and return 'RAND()'; die "rand_function undefined for $driver\n"; } diff -Nru libdbm-deep-perl-2.0010/lib/DBM/Deep.pm libdbm-deep-perl-2.0011/lib/DBM/Deep.pm --- libdbm-deep-perl-2.0010/lib/DBM/Deep.pm 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/lib/DBM/Deep.pm 2014-01-13 02:05:20.000000000 +0000 @@ -6,7 +6,7 @@ use warnings FATAL => 'all'; no warnings 'recursion'; -our $VERSION = q(2.0010); +our $VERSION = q(2.0011); use Scalar::Util (); diff -Nru libdbm-deep-perl-2.0010/lib/DBM/Deep.pod libdbm-deep-perl-2.0011/lib/DBM/Deep.pod --- libdbm-deep-perl-2.0010/lib/DBM/Deep.pod 2013-11-11 14:38:10.000000000 +0000 +++ libdbm-deep-perl-2.0011/lib/DBM/Deep.pod 2014-01-13 02:05:20.000000000 +0000 @@ -4,7 +4,7 @@ =head1 VERSION -2.0010 +2.0011 =head1 SYNOPSIS @@ -182,7 +182,7 @@ This opens a new database handle, mapped to the file "foo.db". If this file does not exist, it will automatically be created. DB files are opened in "r+" (read/write) mode, and the type of object returned is a -hash, unless otherwise specified (see L below). +hash, unless otherwise specified (see L below). You can pass a number of options to the constructor to specify things like locking, autoflush, etc. This is done by passing an inline hash (or hashref): @@ -196,7 +196,7 @@ Notice that the filename is now specified I the hash with the "file" parameter, as opposed to being the sole argument to the constructor. This is required if any options are specified. -See L below for the complete list. +See L below for the complete list. You can also start with an array instead of a hash. For this, you must specify the C parameter: @@ -225,7 +225,7 @@ my $db = tie @array, "DBM::Deep", "bar.db"; As with the OO constructor, you can replace the DB filename parameter with -a hash containing one or more options (see L just below for the +a hash containing one or more options (see L just below for the complete list). tie %hash, "DBM::Deep", { @@ -384,7 +384,7 @@ L, below). DBM::Deep will intercept all reads/writes and direct them to the right place -- the DB file. This has nothing to do with the -L section above. This simply tells you how to use DBM::Deep +L section above. This simply tells you how to use DBM::Deep using regular hashes and arrays, rather than calling functions like C and C (although those work too). It is entirely up to you how to want to access your databases. @@ -464,10 +464,14 @@ =over =item * new() / clone() +X +X These are the constructor and copy-functions. =item * put() / store() +X +X Stores a new hash key/value pair, or sets an array element value. Takes two arguments, the hash key or array index, and the new value. The value can be @@ -477,6 +481,8 @@ $db->put(1, "bar"); # for arrays =item * get() / fetch() +X +X Fetches the value of a hash key or array element. Takes one argument: the hash key or array index. Returns a scalar, hash ref or array ref, depending on the @@ -486,6 +492,7 @@ my $value = $db->get(1); # for arrays =item * exists() +X Checks if a hash key or array index exists. Takes one argument: the hash key or array index. Returns true if it exists, false if not. @@ -494,6 +501,7 @@ if ($db->exists(1)) { print "yay!\n"; } # for arrays =item * delete() +X Deletes one hash key/value pair or array element. Takes one argument: the hash key or array index. Returns the data that the element used to contain (just @@ -507,6 +515,7 @@ $db->delete(1); # for arrays =item * clear() +X Deletes B hash keys or array elements. Takes no arguments. No return value. @@ -514,10 +523,15 @@ $db->clear(); # hashes or arrays =item * lock() / unlock() / lock_exclusive() / lock_shared() +X +X +X +X q.v. L for more info. =item * optimize() +X This will compress the datafile so that it takes up as little space as possible. There is a freespace manager so that when space is freed up, it is used before @@ -528,6 +542,7 @@ in version 1.0003 format, it will be upgraded. =item * import() +X Unlike simple assignment, C does not tie the right-hand side. Instead, a copy of your data is put into the DB. C takes either an arrayref (if @@ -535,6 +550,7 @@ if anything else is passed in. =item * export() +X This returns a complete copy of the data structure at the point you do the export. This copy is in RAM, not on disk like the DB is. @@ -544,6 +560,7 @@ These are the transactional functions. L for more information. =item * supports( $option ) +X This returns a boolean indicating whether this instance of DBM::Deep supports that feature. C<$option> can be one of: @@ -551,12 +568,15 @@ =over 4 =item * transactions +X =item * unicode +X =back =item * db_version() +X This returns the version of the database format that the current database is in. This is specified as the earliest version of DBM::Deep that supports @@ -576,6 +596,7 @@ =over =item * first_key() +X Returns the "first" key in the hash. As with built-in Perl hashes, keys are fetched in an undefined order (which appears random). Takes no arguments, @@ -584,6 +605,7 @@ my $key = $db->first_key(); =item * next_key() +X Returns the "next" key in the hash, given the previous one as the sole argument. Returns undef if there are no more keys to be fetched. @@ -620,12 +642,14 @@ =over =item * length() +X Returns the number of elements in the array. Takes no arguments. my $len = $db->length(); =item * push() +X Adds one or more elements onto the end of the array. Accepts scalars, hash refs or array refs. No return value. @@ -633,6 +657,7 @@ $db->push("foo", "bar", {}); =item * pop() +X Fetches the last element in the array, and deletes it. Takes no arguments. Returns undef if array is empty. Returns the element value. @@ -640,28 +665,32 @@ my $elem = $db->pop(); =item * shift() +X Fetches the first element in the array, deletes it, then shifts all the remaining elements over to take up the space. Returns the element value. This -method is not recommended with large arrays -- see L below for +method is not recommended with large arrays -- see L below for details. my $elem = $db->shift(); =item * unshift() +X Inserts one or more elements onto the beginning of the array, shifting all existing elements over to make room. Accepts scalars, hash refs or array refs. No return value. This method is not recommended with large arrays -- see - below for details. + below for details. $db->unshift("foo", "bar", {}); =item * splice() +X -Performs exactly like Perl's built-in function of the same name. See L for usage -- it is too complicated to document here. This method is -not recommended with large arrays -- see L below for details. +Performs exactly like Perl's built-in function of the same name. See +L for usage -- it is too complicated to document here. This +method is not recommended with large arrays -- see L below for +details. =back @@ -703,7 +732,7 @@ This causes DBM::Deep to C the underlying filehandle with exclusive mode for writes, and shared mode for reads. This is required if you have multiple processes accessing the same database file, to avoid file corruption. -Please note that C does NOT work for files over NFS. See L does NOT work for files over NFS. See L below for more. =head2 Explicit Locking @@ -1045,9 +1074,9 @@ This section describes all the known issues with DBM::Deep. These are issues that are either intractable or depend on some feature within Perl working exactly right. It you have found something that is not listed below, please -send an e-mail to L. Likewise, if you think you -know of a -way around one of these issues, please let me know. +send an e-mail to L. +Likewise, if you think you know of a way around one of these issues, please +let me know. =head2 References @@ -1247,16 +1276,16 @@ =head1 MORE INFORMATION Check out the DBM::Deep Google Group at L -or send email to L. You can also visit #dbm-deep on -irc.perl.org +or send email to L. +You can also visit #dbm-deep on irc.perl.org The source code repository is at L =head1 MAINTAINERS -Rob Kinyon, L +Rob Kinyon, L -Originally written by Joseph Huckaby, L +Originally written by Joseph Huckaby, L =head1 SPONSORS @@ -1279,6 +1308,8 @@ =item * David Steinbrunner for fixing typos and adding repository cpan metadata +=item * H. Merijn Brandt for fixing the POD escapes. + =back =head1 SEE ALSO @@ -1290,7 +1321,7 @@ =head1 LICENSE -Copyright (c) 2007 Rob Kinyon. All Rights Reserved. +Copyright (c) 2007-14 Rob Kinyon. All Rights Reserved. This is free software, you may use it and distribute it under the same terms as Perl itself.