bump version to 1.000005
[p5sagit/Safe-Isa.git] / lib / Safe / Isa.pm
index b725f21..a42566f 100644 (file)
@@ -3,9 +3,9 @@ package Safe::Isa;
 use strict;
 use warnings FATAL => 'all';
 use Scalar::Util qw(blessed);
-use base qw(Exporter);
+use Exporter 5.57 qw(import);
 
-our $VERSION = '1.000000';
+our $VERSION = '1.000005';
 
 our @EXPORT = qw($_call_if_object $_isa $_can $_does $_DOES);
 
@@ -69,9 +69,9 @@ And just in case we missed a method:
 
 Or to re-use a previous example for purposes of explication:
 
-  $foo->$_call_if_method(isa => 'Foo');  # true
-  $bar->$_call_if_method(isa => 'Foo');  # true
-  $blam->$_call_if_method(isa => 'Foo'); # false, no boom today
+  $foo->$_call_if_object(isa => 'Foo');  # true
+  $bar->$_call_if_object(isa => 'Foo');  # true
+  $blam->$_call_if_object(isa => 'Foo'); # false, no boom today
 
 =head1 DESCRIPTION
 
@@ -103,6 +103,11 @@ is equivalent to
     }
   };
 
+Note that we don't handle trying class names, because many things are valid
+class names that you might not want to treat as one (like say "Matt") - the
+C<is_module_name> function from L<Module::Runtime> is a good way to check for
+something you might be able to call methods on if you want to do that.
+
 =head1 EXPORTS
 
 =head2 $_isa
@@ -133,9 +138,9 @@ returns nothing.
 If called on an object, calls C<DOES> on it and returns the result, otherwise
 returns nothing.
 
-=head2 $_call_if_method
+=head2 $_call_if_object
 
-  $maybe_an_object->$_call_if_method(method_name => @args);
+  $maybe_an_object->$_call_if_object(method_name => @args);
 
 If called on an object, calls C<method_name> on it and returns the result,
 otherwise returns nothing.