This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
dd322fd6d249599e5d3b1c2b1256dd21306345b0
[perl5.git] / 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