Abolish wrapped in struct regexp - store the wrapped pattern pointer

[p5sagit/p5-mst-13.2.git] / ext / Win32CORE / Win32CORE.pm

diff --git a/ext/Win32CORE/Win32CORE.pm b/ext/Win32CORE/Win32CORE.pm
index 979dd84..0e5d20b 100644 (file)
--- a/ext/Win32CORE/Win32CORE.pm
+++ b/ext/Win32CORE/Win32CORE.pm
@@ -1,26 +1,38 @@
 package Win32CORE;
 
-$VERSION = '0.01';
+$VERSION = '0.02';
 
-use strict;
-use warnings;
-use vars qw($VERSION @ISA);
-use base qw(Exporter DynaLoader);
-no warnings "redefine";
-
-bootstrap Win32CORE $VERSION;
+# There is no reason to load this module explicitly.  It will be
+# initialized using xs_init() when the interpreter is constructed.
 
 1;
+
 __END__
+
 =head1 NAME
 
-Win32CORE - Win32 CORE functions
+Win32CORE - Win32 CORE function stubs
 
 =head1 DESCRIPTION
 
-This library provides the functions marked as [CORE] in L<Win32>. See that
-document for usage information.  In cygwin, as of 5.8.6 it is no longer
-necessary to use this module; the functions should be available even without
-C<use Win32CORE;> or C<-MWin32CORE>.
+This library provides stubs for the functions marked as [CORE] in L<Win32>.
+See that document for usage information.  When any of these functions are
+called, the full Win32 module is loaded automatically.  It is preferred
+that callers of these functions explicitly C<use Win32;>.
+
+=head1 HISTORY
+
+Win32CORE was created to provide on cygwin those Win32:: functions that
+for regular win32 builds were provided by default in perl.  In cygwin
+perl releases prior to 5.8.6, this module was standalone and had to
+be explicitly used.  In 5.8.6 and later, it was statically linked into
+cygwin perl so this would no longer be necessary.
+
+As of perl 5.9.5/Win32 0.27, these functions have been moved into
+the Win32 module.  Win32CORE provides stubs for each of the former
+CORE Win32:: functions that internally just load the Win32 module and
+call it's version, and Win32CORE is statically linked to perl for both
+cygwin and regular win32 builds.  This will permit these functions to
+be updated in the CPAN Win32 module independently of updating perl.
 
 =cut