ext/Win32CORE/Win32CORE.pm

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