This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
RE: Problem in Win32CORE when building PAR-Packer-0.975 with bleadperl on Win32
[perl5.git] / 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