summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--lib/lexically.pm57
1 files changed, 57 insertions, 0 deletions
diff --git a/lib/lexically.pm b/lib/lexically.pm
index ee41007..422312c 100644
--- a/lib/lexically.pm
+++ b/lib/lexically.pm
@@ -1,10 +1,25 @@
package lexically;
use strict;
use warnings;
+# ABSTRACT: lexically import functions from non-lexical exporters
use Exporter::Lexical 0.02 ();
use Module::Runtime 'require_module';
+=head1 SYNOPSIS
+
+ package Foo;
+ use Moose;
+ use lexically 'Scalar::Util' => 'reftype';
+
+=head1 DESCRIPTION
+
+This pragma turns normal package-based exporter modules into lexical exporters.
+This can be useful to ensure that your package namespace doesn't get polluted
+(preventing the need for something like L<namespace::clean> entirely).
+
+=cut
+
our $INDEX = 0;
sub import {
@@ -36,4 +51,46 @@ sub import {
delete $lexically::{"scratchpad_${index}::"};
}
+=head1 BUGS
+
+No known bugs.
+
+Please report any bugs to GitHub Issues at L<https://github.com/doy/lexically/issues>.
+
+=head1 SEE ALSO
+
+L<Exporter::Lexical>
+
+=back
+
+=head1 SUPPORT
+
+You can find this documentation for this module with the perldoc command.
+
+ perldoc lexically
+
+You can also look for information at:
+
+=over 4
+
+=item * MetaCPAN
+
+L<https://metacpan.org/release/lexically>
+
+=item * Github
+
+L<https://github.com/doy/lexically>
+
+=item * RT: CPAN's request tracker
+
+L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=lexically>
+
+=item * CPAN Ratings
+
+L<http://cpanratings.perl.org/d/lexically>
+
+=back
+
+=cut
+
1;