Commit | Line | Data |
78ff2d7b |
1 | package Win32CORE; |
2 | |
9fb265f7 |
3 | $VERSION = '0.02'; |
78ff2d7b |
4 | |
9fb265f7 |
5 | # There is no reason to load this module explicitly. It will be |
6 | # initialized using xs_init() when the interpreter is constructed. |
78ff2d7b |
7 | |
8 | 1; |
9fb265f7 |
9 | |
78ff2d7b |
10 | __END__ |
9fb265f7 |
11 | |
78ff2d7b |
12 | =head1 NAME |
13 | |
82adc83d |
14 | Win32CORE - Win32 CORE function stubs |
78ff2d7b |
15 | |
16 | =head1 DESCRIPTION |
17 | |
82adc83d |
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. |
78ff2d7b |
37 | |
38 | =cut |