ext/Win32CORE/Win32CORE.pm

   1 package Win32CORE;
   2
   3 $VERSION = '0.01';
   4
   5 use strict;
   6 use warnings;
   7 use vars qw($VERSION @ISA);
   8 use base qw(Exporter DynaLoader);
   9 no warnings "redefine";
  10
  11 bootstrap Win32CORE $VERSION;
  12
  13 1;
  14 __END__
  15 =head1 NAME
  16
  17 Win32CORE - Win32 CORE function stubs
  18
  19 =head1 DESCRIPTION
  20
  21 This library provides stubs for the functions marked as [CORE] in L<Win32>.
  22 See that document for usage information.  When any of these functions are
  23 called, the full Win32 module is loaded automatically.  It is preferred
  24 that callers of these functions explicitly C<use Win32;>.
  25
  26 =head1 HISTORY
  27
  28 Win32CORE was created to provide on cygwin those Win32:: functions that
  29 for regular win32 builds were provided by default in perl.  In cygwin
  30 perl releases prior to 5.8.6, this module was standalone and had to
  31 be explicitly used.  In 5.8.6 and later, it was statically linked into
  32 cygwin perl so this would no longer be necessary.
  33
  34 As of perl 5.9.5/Win32 0.27, these functions have been moved into
  35 the Win32 module.  Win32CORE provides stubs for each of the former
  36 CORE Win32:: functions that internally just load the Win32 module and
  37 call it's version, and Win32CORE is statically linked to perl for both
  38 cygwin and regular win32 builds.  This will permit these functions to
  39 be updated in the CPAN Win32 module independently of updating perl.
  40
  41 =cut