Commit | Line | Data |
c53d2df2 |
1 | package Package::Stash::XS; |
2 | use strict; |
3 | use warnings; |
4 | # ABSTRACT: faster and more correct implementation of the Package::Stash API |
5 | |
6 | use XSLoader; |
7 | XSLoader::load( |
8 | __PACKAGE__, |
9 | # we need to be careful not to touch $VERSION at compile time, otherwise |
10 | # DynaLoader will assume it's set and check against it, which will cause |
11 | # fail when being run in the checkout without dzil having set the actual |
12 | # $VERSION |
13 | exists $Package::Stash::XS::{VERSION} |
14 | ? ${ $Package::Stash::XS::{VERSION} } : (), |
15 | ); |
16 | |
17 | =head1 SYNOPSIS |
18 | |
19 | use Package::Stash; |
20 | |
21 | =head1 DESCRIPTION |
22 | |
23 | This is a backend for L<Package::Stash>, which provides the functionality in a |
24 | way that's less buggy and much faster. It will be used by default if it's |
25 | installed, and should be preferred in all environments with a compiler. |
26 | |
27 | =head1 BUGS / CAVEATS |
28 | |
29 | =over 4 |
30 | |
31 | =item * On perl versions prior to 5.10, undefined package scalars will not show up as existing, due to shortcomings within perl. |
32 | |
33 | =item * GLOB and FORMAT variables are not (yet) accessible through this module. |
34 | |
35 | =back |
36 | |
37 | Please report any bugs through RT: email |
38 | C<bug-package-stash-xs at rt.cpan.org>, or browse to |
39 | L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Package-Stash-XS>. |
40 | |
41 | =head1 SEE ALSO |
42 | |
43 | =over 4 |
44 | |
45 | =item * L<Class::MOP::Package> |
46 | |
47 | This module is a factoring out of code that used to live here |
48 | |
49 | =back |
50 | |
51 | =head1 SUPPORT |
52 | |
53 | You can find this documentation for this module with the perldoc command. |
54 | |
55 | perldoc Package::Stash::XS |
56 | |
57 | You can also look for information at: |
58 | |
59 | =over 4 |
60 | |
61 | =item * AnnoCPAN: Annotated CPAN documentation |
62 | |
63 | L<http://annocpan.org/dist/Package-Stash-XS> |
64 | |
65 | =item * CPAN Ratings |
66 | |
67 | L<http://cpanratings.perl.org/d/Package-Stash-XS> |
68 | |
69 | =item * RT: CPAN's request tracker |
70 | |
71 | L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Package-Stash-XS> |
72 | |
73 | =item * Search CPAN |
74 | |
75 | L<http://search.cpan.org/dist/Package-Stash-XS> |
76 | |
77 | =back |
78 | |
79 | =head1 AUTHOR |
80 | |
81 | Jesse Luehrs <doy at tozt dot net> |
82 | |
83 | Based on code from L<Class::MOP::Package>, by Stevan Little and the Moose |
84 | Cabal. |
85 | |
86 | =cut |
87 | |
88 | 1; |