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 | |
1794a42b |
31 | =item * Prior to perl 5.10, scalar slots are only considered to exist if they are defined |
c53d2df2 |
32 | |
0cb52327 |
33 | This is due to a shortcoming within perl itself. See |
1794a42b |
34 | L<perlref/Making References> point 7 for more information. |
c53d2df2 |
35 | |
36 | =back |
37 | |
38 | Please report any bugs through RT: email |
39 | C<bug-package-stash-xs at rt.cpan.org>, or browse to |
40 | L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Package-Stash-XS>. |
41 | |
42 | =head1 SEE ALSO |
43 | |
44 | =over 4 |
45 | |
46 | =item * L<Class::MOP::Package> |
47 | |
48 | This module is a factoring out of code that used to live here |
49 | |
50 | =back |
51 | |
52 | =head1 SUPPORT |
53 | |
54 | You can find this documentation for this module with the perldoc command. |
55 | |
56 | perldoc Package::Stash::XS |
57 | |
58 | You can also look for information at: |
59 | |
60 | =over 4 |
61 | |
62 | =item * AnnoCPAN: Annotated CPAN documentation |
63 | |
64 | L<http://annocpan.org/dist/Package-Stash-XS> |
65 | |
66 | =item * CPAN Ratings |
67 | |
68 | L<http://cpanratings.perl.org/d/Package-Stash-XS> |
69 | |
70 | =item * RT: CPAN's request tracker |
71 | |
72 | L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Package-Stash-XS> |
73 | |
74 | =item * Search CPAN |
75 | |
76 | L<http://search.cpan.org/dist/Package-Stash-XS> |
77 | |
78 | =back |
79 | |
80 | =head1 AUTHOR |
81 | |
82 | Jesse Luehrs <doy at tozt dot net> |
83 | |
84 | Based on code from L<Class::MOP::Package>, by Stevan Little and the Moose |
85 | Cabal. |
86 | |
0cb52327 |
87 | =begin Pod::Coverage |
88 | |
89 | add_symbol |
90 | get_all_symbols |
91 | get_or_add_symbol |
92 | get_symbol |
93 | has_symbol |
94 | list_all_symbols |
95 | name |
96 | namespace |
97 | new |
98 | remove_glob |
99 | remove_symbol |
100 | |
101 | =end Pod::Coverage |
102 | |
c53d2df2 |
103 | =cut |
104 | |
105 | 1; |