threads is no longer customized, as of commit c0ff91434b

[perl5.git] / ext / GDBM_File / GDBM_File.pm

diff --git a/ext/GDBM_File/GDBM_File.pm b/ext/GDBM_File/GDBM_File.pm
index 73bcdbe..a06fa13 100644 (file)
--- a/ext/GDBM_File/GDBM_File.pm
+++ b/ext/GDBM_File/GDBM_File.pm
@@ -1,43 +1,76 @@
+# GDBM_File.pm -- Perl 5 interface to GNU gdbm library.
+
+=head1 NAME
+
+GDBM_File - Perl5 access to the gdbm library.
+
+=head1 SYNOPSIS
+
+    use GDBM_File ;
+    tie %hash, 'GDBM_File', $filename, &GDBM_WRCREAT, 0640;
+    # Use the %hash array.
+    untie %hash ;
+
+=head1 DESCRIPTION
+
+B<GDBM_File> is a module which allows Perl programs to make use of the
+facilities provided by the GNU gdbm library.  If you intend to use this
+module you should really have a copy of the gdbm manualpage at hand.
+
+Most of the libgdbm.a functions are available through the GDBM_File
+interface.
+
+=head1 AVAILABILITY
+
+gdbm is available from any GNU archive.  The master site is
+C<ftp.gnu.org>, but you are strongly urged to use one of the many
+mirrors.  You can obtain a list of mirror sites from
+http://www.gnu.org/order/ftp.html.
+
+=head1 BUGS
+
+The available functions and the gdbm/perl interface need to be documented.
+
+The GDBM error number and error message interface needs to be added.
+
+=head1 SEE ALSO
+
+L<perl(1)>, L<DB_File(3)>, L<perldbmfilter>. 
+
+=cut
+
 package GDBM_File;
 
+use strict;
+use warnings;
+our($VERSION, @ISA, @EXPORT);
+
 require Carp;
-require TieHash;
+require Tie::Hash;
 require Exporter;
-use AutoLoader;
-require DynaLoader;
-@ISA = qw(TieHash Exporter DynaLoader);
+require XSLoader;
+@ISA = qw(Tie::Hash Exporter);
 @EXPORT = qw(
        GDBM_CACHESIZE
+       GDBM_CENTFREE
+       GDBM_COALESCEBLKS
        GDBM_FAST
+       GDBM_FASTMODE
        GDBM_INSERT
        GDBM_NEWDB
+       GDBM_NOLOCK
+       GDBM_OPENMASK
        GDBM_READER
        GDBM_REPLACE
+       GDBM_SYNC
+       GDBM_SYNCMODE
        GDBM_WRCREAT
        GDBM_WRITER
 );
 
-sub AUTOLOAD {
-    local($constname);
-    ($constname = $AUTOLOAD) =~ s/.*:://;
-    $val = constant($constname, @_ ? $_[0] : 0);
-    if ($! != 0) {
-       if ($! =~ /Invalid/) {
-           $AutoLoader::AUTOLOAD = $AUTOLOAD;
-           goto &AutoLoader::AUTOLOAD;
-       }
-       else {
-           Carp::croak("Your vendor has not defined GDBM_File macro $constname, used");
-       }
-    }
-    eval "sub $AUTOLOAD { $val }";
-    goto &$AUTOLOAD;
-}
-
-bootstrap GDBM_File;
-
-# Preloaded methods go here.  Autoload methods go after __END__, and are
-# processed by the autosplit program.
+# This module isn't dual life, so no need for dev version numbers.
+$VERSION = '1.15';
+
+XSLoader::load();
 
 1;
-__END__