Committed fix for RT#35140
rkinyon@cpan.org [Wed, 14 May 2008 14:13:43 +0000 (14:13 +0000)]
git-svn-id: http://svn.ali.as/cpan/trunk/DBM-Deep@3349 88f4d9cd-8a04-0410-9d60-8f63309c3137

Changes
lib/DBM/Deep.pm
lib/DBM/Deep.pod
lib/DBM/Deep/Array.pm
lib/DBM/Deep/Cookbook.pod
lib/DBM/Deep/Engine.pm
lib/DBM/Deep/File.pm
lib/DBM/Deep/Hash.pm
lib/DBM/Deep/Internals.pod

diff --git a/Changes b/Changes
index b2f01a5..805455e 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,5 +1,9 @@
 Revision history for DBM::Deep.
 
+1.0010 May 14 12:00:00 2008 EST
+    - (This version is compatible with 1.0009)
+    - Fix for RT#35140 (invalid POD links)
+
 1.0009 Mar 19 12:00:00 2008 EDT
     - (This version is compatible with 1.0008)
     - Internal refactorings to prepare for some optimizations.
index 58e77ee..09c6f85 100644 (file)
@@ -5,7 +5,7 @@ use 5.006_000;
 use strict;
 use warnings;
 
-our $VERSION = q(1.0009);
+our $VERSION = q(1.0010);
 
 use Fcntl qw( :flock );
 use Scalar::Util ();
index 0711b5e..cd9f6f7 100644 (file)
@@ -99,7 +99,7 @@ the wrong type is passed in.
 Alternately, you can create a DBM::Deep handle by using Perl's built-in
 tie() function. The object returned from tie() can be used to call methods,
 such as lock() and unlock(). (That object can be retrieved from the tied
-variable at any time using tied() - please see L<perltie/> for more info.
+variable at any time using tied() - please see L<perltie> for more info.
 
   my %hash;
   my $db = tie %hash, "DBM::Deep", "foo.db";
@@ -576,7 +576,7 @@ You can pass C<lock()> an optional argument, which specifies which mode to use
 (exclusive or shared). Use one of these two constants:
 C<DBM::Deep-E<gt>LOCK_EX> or C<DBM::Deep-E<gt>LOCK_SH>. These are passed
 directly to C<flock()>, and are the same as the constants defined in Perl's
-L<Fcntl/> module.
+L<Fcntl> module.
 
   $db->lock( $db->LOCK_SH );
   # something here
@@ -718,7 +718,7 @@ remove a filter, set the function reference to C<undef>:
 
 =head2 Examples
 
-Please read L<DBM::Deep::Manual/> for examples of filters.
+Please read L<DBM::Deep::Manual> for examples of filters.
 
 =head1 ERROR HANDLING
 
@@ -889,7 +889,7 @@ welcome.
 
 Right now, importing is done using C<Clone::clone()> to make a complete copy
 in memory, then tying that copy. It would be much better to use
-L<Data::Walker/> to walk the data structure instead, particularly in the case
+L<Data::Walker> to walk the data structure instead, particularly in the case
 of large datastructures.
 
 =head2 Different contention resolution mechanisms
@@ -952,7 +952,7 @@ all to support a feature that has never been requested.
 
 =item * CODE
 
-L<Data::Dump::Streamer/> provides a mechanism for serializing coderefs,
+L<Data::Dump::Streamer> provides a mechanism for serializing coderefs,
 including saving off all closure state. This would allow for DBM::Deep to
 store the code for a subroutine. Then, whenever the subroutine is read, the
 code could be C<eval()>'ed into being. However, just as for SCALAR and REF,
@@ -1037,8 +1037,8 @@ reference to be imported in order to explicitly leave it untied.
 
 =head1 CODE COVERAGE
 
-L<Devel::Cover/> is used to test the code coverage of the tests. Below is the
-L<Devel::Cover/> report on this distribution's test suite.
+L<Devel::Cover> is used to test the code coverage of the tests. Below is the
+L<Devel::Cover> report on this distribution's test suite.
 
   ------------------------------------------ ------ ------ ------ ------ ------
   File                                         stmt   bran   cond    sub  total
index 3b0c8bd..0ee4abc 100644 (file)
@@ -5,7 +5,7 @@ use 5.006_000;
 use strict;
 use warnings;
 
-our $VERSION = q(1.0009);
+our $VERSION = q(1.0010);
 
 # This is to allow DBM::Deep::Array to handle negative indices on
 # its own. Otherwise, Perl would intercept the call to negative
index 7c62c16..4ca50b9 100644 (file)
@@ -4,7 +4,7 @@ DBM::Deep::Cookbook
 
 =head1 DESCRIPTION
 
-This is the Cookbook for L<DBM::Deep/>. It contains useful tips and tricks,
+This is the Cookbook for L<DBM::Deep>. It contains useful tips and tricks,
 plus some examples of how to do common tasks.
 
 =head1 RECIPES
@@ -24,7 +24,7 @@ In 5.6, you will have to do the following:
   $db->set_filter( 'retrieve_value' => sub { pack "C*", unpack "U0C*", $_[0] } );
 
 In a future version, you will be able to specify C<utf8 =E<gt> 1> and
-L<DBM::Deep/> will do these things for you.
+L<DBM::Deep> will do these things for you.
 
 =head2 Real-time Encryption Example
 
index d2d0f4b..8364128 100644 (file)
@@ -5,7 +5,7 @@ use 5.006_000;
 use strict;
 use warnings;
 
-our $VERSION = q(1.0009);
+our $VERSION = q(1.0010);
 
 use Scalar::Util ();
 
index 042cbaa..dc0b002 100644 (file)
@@ -5,7 +5,7 @@ use 5.006_000;
 use strict;
 use warnings;
 
-our $VERSION = q(1.0009);
+our $VERSION = q(1.0010);
 
 use Fcntl qw( :DEFAULT :flock :seek );
 use FileHandle::Fmode ();
index d4ae61d..fee93c0 100644 (file)
@@ -5,7 +5,7 @@ use 5.006_000;
 use strict;
 use warnings;
 
-our $VERSION = q(1.0009);
+our $VERSION = q(1.0010);
 
 use base 'DBM::Deep';
 
index cc851ed..132bc9e 100644 (file)
@@ -8,33 +8,33 @@ B<NOTE>: This document is out-of-date. It describes an intermediate file
 format used during the development from 0.983 to 1.0000. It will be rewritten
 soon.
 
-This is a document describing the internal workings of L<DBM::Deep/>. It is
+This is a document describing the internal workings of L<DBM::Deep>. It is
 not necessary to read this document if you only intend to be a user. This
 document is intended for people who either want a deeper understanding of
-specifics of how L<DBM::Deep/> works or who wish to help program
-L<DBM::Deep/>.
+specifics of how L<DBM::Deep> works or who wish to help program
+L<DBM::Deep>.
 
 =head1 CLASS LAYOUT
 
-L<DBM::Deep/> is broken up into five classes in three inheritance hierarchies.
+L<DBM::Deep> is broken up into five classes in three inheritance hierarchies.
 
 =over 4
 
 =item *
 
-L<DBM::Deep/> is the parent of L<DBM::Deep::Array/> and L<DBM::Deep::Hash/>.
+L<DBM::Deep> is the parent of L<DBM::Deep::Array> and L<DBM::Deep::Hash>.
 These classes form the immediate interface to the outside world. They are the
 classes that provide the TIE mechanisms as well as the OO methods.
 
 =item *
 
-L<DBM::Deep::Engine/> is the layer that deals with the mechanics of reading
+L<DBM::Deep::Engine> is the layer that deals with the mechanics of reading
 and writing to the file. This is where the logic of the file layout is
 handled.
 
 =item *
 
-L<DBM::Deep::File/> is the layer that deals with the physical file. As a
+L<DBM::Deep::File> is the layer that deals with the physical file. As a
 singleton that every other object has a reference to, it also provides a place
 to handle datastructure-wide items, such as transactions.
 
@@ -135,10 +135,10 @@ than the key.
 
 =head1 PERFORMANCE
 
-L<DBM::Deep/> is written completely in Perl. It also is a multi-process DBM
+L<DBM::Deep> is written completely in Perl. It also is a multi-process DBM
 that uses the datafile as a method of synchronizing between multiple
 processes. This is unlike most RDBMSes like MySQL and Oracle. Furthermore,
-unlike all RDBMSes, L<DBM::Deep/> stores both the data and the structure of
+unlike all RDBMSes, L<DBM::Deep> stores both the data and the structure of
 that data as it would appear in a Perl program.
 
 =head2 CPU
@@ -260,9 +260,9 @@ Run time was 12 min 3 sec.
 
 =head2 MEMORY USAGE
 
-One of the great things about L<DBM::Deep/> is that it uses very little memory.
+One of the great things about L<DBM::Deep> is that it uses very little memory.
 Even with huge databases (1,000,000+ keys) you will not see much increased
-memory on your process.  L<DBM::Deep/> relies solely on the filesystem for storing
+memory on your process.  L<DBM::Deep> relies solely on the filesystem for storing
 and fetching data.  Here is output from I<top> before even opening a database
 handle: