From: Graham Knop <haarg@haarg.org>
Date: Mon, 9 Apr 2018 09:47:44 +0000 (+0200)
Subject: document behavior of does/DOES when methods are missing
X-Git-Tag: v1.000009~3
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=5268d11199983a86db426ebe9554624794ddf1cb;hp=9d3d6b490907e28992f225d4527a0460acb3c1d2;p=p5sagit%2FSafe-Isa.git

document behavior of does/DOES when methods are missing
---

diff --git a/lib/Safe/Isa.pm b/lib/Safe/Isa.pm
index fb3c5ab..92c3b6f 100644
--- a/lib/Safe/Isa.pm
+++ b/lib/Safe/Isa.pm
@@ -160,14 +160,17 @@ returns nothing.
   $maybe_an_object->$_does('Foo');
 
 If called on an object, calls C<does> on it and returns the result, otherwise
-returns nothing.
+returns nothing. If the C<does> method does not exist, returns nothing rather
+than failing.
 
 =head2 $_DOES
 
   $maybe_an_object->$_DOES('Foo');
 
 If called on an object, calls C<DOES> on it and returns the result, otherwise
-returns nothing.
+returns nothing. On perl versions prior to 5.10.0, the built in core C<DOES>
+method doesn't exist. If the method doesn't exist, this will fall back to
+calling C<isa> just like the core C<DOES> method.
 
 =head2 $_call_if_object