summaryrefslogtreecommitdiff
path: root/ext/Win32CORE/Win32CORE.pm
blob: dd322fd6d249599e5d3b1c2b1256dd21306345b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
package Win32CORE;

$VERSION = '0.01';

use strict;
use warnings;
use vars qw($VERSION @ISA);
use base qw(Exporter DynaLoader);
no warnings "redefine";

bootstrap Win32CORE $VERSION;

1;
__END__
=head1 NAME

Win32CORE - Win32 CORE function stubs

=head1 DESCRIPTION

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