bump version to 1.002002

[p5sagit/Import-Into.git] / lib / Import / Into.pm

diff --git a/lib/Import/Into.pm b/lib/Import/Into.pm
index 71f1507..84effea 100644 (file)
--- a/lib/Import/Into.pm
+++ b/lib/Import/Into.pm
@@ -3,7 +3,7 @@ package Import::Into;
 use strict;
 use warnings FATAL => 'all';
 
-our $VERSION = '1.001001'; # 1.1.1
+our $VERSION = '1.002002'; # 1.2.2
 
 sub _prelude {
   my $target = shift;
@@ -40,7 +40,9 @@ sub unimport::out_of {
 }
 
 1;
- 
+
+__END__
+
 =head1 NAME
 
 Import::Into - import packages into other packages
@@ -83,11 +85,10 @@ Import::Into - import packages into other packages
     Thing1->unimport::out_of(scalar caller);
   }
 
-You don't need to do anything more clever than this provided you
-document that people wanting to re-export your module should also be using
-L<Import::Into>.
+People wanting to re-export your module should also be using L<Import::Into>.
+Any exporter or pragma will work seamlessly.
 
-Note: You do B<not> need to make ayny changes to Thing1 to be able to call
+Note: You do B<not> need to make any changes to Thing1 to be able to call
 C<import::into> on it. This is a global method, and is callable on any
 package (and in fact on any object as well, although it's rarer that you'd
 want to do that).
@@ -111,7 +112,8 @@ C<Import::Into> provides global methods to make this painless.
 A global method, callable on any package.  Imports the given package into
 C<$target>.  C<@arguments> are passed along to the package's import method.
 
-C<$target> can be an package name to export to, an integer for the caller level to export to, or a hashref with the following options:
+C<$target> can be an package name to export to, an integer for the
+caller level to export to, or a hashref with the following options:
 
 =over 4
 
@@ -121,25 +123,32 @@ The target package to export to.
 
 =item filename
 
-The apparent filename to export to.  Some exporting modules, such as L<autodie> or L<strictures>, care about the filename they are being imported to.
+The apparent filename to export to.  Some exporting modules, such as
+L<autodie> or L<strictures>, care about the filename they are being imported
+to.
 
 =item line
 
-The apparent line number to export to.  To be combined with the C<filename> option.
+The apparent line number to export to.  To be combined with the C<filename>
+option.
 
 =item level
 
-The caller level to export to.  This will automatically populate the C<package>, C<filename>, and C<line> options, making it the easiest most constent option.
+The caller level to export to.  This will automatically populate the
+C<package>, C<filename>, and C<line> options, making it the easiest most
+constent option.
 
 =item version
 
-A version number to check for the module.  The equivalent of specifying the version number on a C<use> line.
+A version number to check for the module.  The equivalent of specifying the
+version number on a C<use> line.
 
 =back
 
 =head2 $package->unimport::out_of( $target, @arguments );
 
-Equivalent to C<import::into>, but dispatches to C<$package>'s C<unimport> method instead of C<import>.
+Equivalent to C<import::into>, but dispatches to C<$package>'s C<unimport>
+method instead of C<import>.
 
 =head1 WHY USE THIS MODULE
 
@@ -204,6 +213,9 @@ in the directive then need to be fetched using C<caller>:
   };
   $sub->($thing, @import_args);
 
+And you need to switch between these implementations depending on if you are
+targeting a specific package, or something in your call stack.
+
 Remembering all this, however, is excessively irritating. So I wrote a module
 so I didn't have to anymore. Loading L<Import::Into> creates a global method
 C<import::into> which you can call on any package to import it into another
@@ -250,6 +262,11 @@ you're receiving this from a parameter, I recommend using L<Module::Runtime>:
 
 And that's it.
 
+=head1 SEE ALSO
+
+I gave a lightning talk on this module (and L<curry> and L<Safe::Isa>) at
+L<YAPC::NA 2013|https://www.youtube.com/watch?v=wFXWV2yY7gE&t=46m05s>.
+
 =head1 ACKNOWLEDGEMENTS
 
 Thanks to Getty for asking "how can I get C<< use strict; use warnings; >>
@@ -273,3 +290,5 @@ as listed above.
 
 This library is free software and may be distributed under the same terms
 as perl itself.
+
+=cut