Add descriptions to pods

[gitmo/Mouse.git] / lib / Squirrel.pm

diff --git a/lib/Squirrel.pm b/lib/Squirrel.pm
index f10d7cb..bbbad76 100644 (file)
--- a/lib/Squirrel.pm
+++ b/lib/Squirrel.pm
@@ -5,15 +5,17 @@ use warnings;
 sub _choose_backend {
     if ( $INC{"Moose.pm"} ) {
         return {
+            backend  => 'Moose',
             import   => \&Moose::import,
             unimport => \&Moose::unimport,
-        }
+        };
     } else {
         require Mouse;
         return {
+            backend  => 'Mouse',
             import   => \&Mouse::import,
             unimport => \&Mouse::unimport,
-        }
+        };
     }
 }
 
@@ -24,16 +26,22 @@ sub _handlers {
 
     my $caller = caller(1);
 
-    $pkgs{$caller} = $class->_choose_backend
-        unless $pkgs{$caller};
+    $pkgs{$caller} ||= $class->_choose_backend;
 }
 
 sub import {
-    goto $_[0]->_handlers->{import};
+    require Carp;
+    Carp::carp("Squirrel is deprecated. Please use Any::Moose instead. It fixes a number of design problems that Squirrel has.");
+
+    my $handlers = shift->_handlers;
+    unshift @_, $handlers->{backend};
+    goto &{$handlers->{import}};
 }
 
 sub unimport {
-    goto $_[0]->_handlers->{unimport};
+    my $handlers = shift->_handlers;
+    unshift @_, $handlers->{backend};
+    goto &{$handlers->{unimport}};
 }
 
 1;
@@ -44,11 +52,11 @@ __END__
 
 =head1 NAME
 
-Squirrel - Use L<Mouse>, unless L<Moose> is already loaded.
+Squirrel - Use Mouse, unless Moose is already loaded. (DEPRECATED)
 
 =head1 SYNOPSIS
 
-       use Squirrel;
+    use Squirrel;
 
     has goggles => (
         is => "rw", 
@@ -56,12 +64,12 @@ Squirrel - Use L<Mouse>, unless L<Moose> is already loaded.
 
 =head1 DEPRECATION
 
-L<Squirrel> is being deprecated. L<Any::Moose> provides the same functionality,
+C<Squirrel> is deprecated. C<Any::Moose> provides the same functionality,
 but better. :)
 
 =head1 DESCRIPTION
 
-L<Moose> and L<Squirrel> are TEH BEST FRENDS, but if L<Moose> isn't there
+L<Moose> and L<Squirrel> are THE BEST FRIENDS, but if L<Moose> isn't there
 L<Squirrel> will hang out with L<Mouse> as well.
 
 When your own code doesn't actually care whether or not you use L<Moose> or
@@ -71,6 +79,10 @@ This lets you run with minimal dependencies and have a faster startup, but if
 L<Moose> is already in use you get all the benefits of using that
 (transformability, introspection, more opportunities for code reuse, etc).
 
+=head1 SEE ALSO
+
+L<Any::Moose>
+
 =cut