[p5sagit/p5-mst-13.2.git] / ext / Win32CORE / Win32CORE.pm

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
Commit	Line	Data
78ff2d7b	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
82adc83d	17	Win32CORE - Win32 CORE function stubs
78ff2d7b	18
	19	=head1 DESCRIPTION
	20
82adc83d	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.
78ff2d7b	40
78ff2d7b	41	=cut