From: Father Chrysostomos <sprout@cpan.org>
Date: Sat, 30 Oct 2010 05:12:55 +0000 (-0700)
Subject: perlmroapi: suggest HvNAME as a fallback
X-Git-Tag: accepted/trunk/20130322.191538~7065
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=2ffab0983a1bec84ae1240ada5aa5e685645180b;p=platform%2Fupstream%2Fperl.git

perlmroapi: suggest HvNAME as a fallback
---

diff --git a/pod/perlmroapi.pod b/pod/perlmroapi.pod
index f010b75..74bd9b2 100644
--- a/pod/perlmroapi.pod
+++ b/pod/perlmroapi.pod
@@ -55,12 +55,14 @@ depth if it needs to recurse.
 
 The function should return a reference to an array containing the parent
 classes in order. The names of the classes should be the result of calling
-C<HvENAME()> on the stash. The caller is responsible for incrementing the
-reference count of the array returned if it wants to keep the structure.
-Hence, if you have created a temporary value that you keep no pointer to,
-C<sv_2mortal()> to ensure that it is disposed of correctly. If you have
-cached your return value, then return a pointer to it without changing the
-reference count.
+C<HvENAME()> on the stash. In those cases where C<HvENAME()> returns null,
+C<HvNAME()> should be used instead.
+
+The caller is responsible for incrementing the reference count of the array
+returned if it wants to keep the structure. Hence, if you have created a
+temporary value that you keep no pointer to, C<sv_2mortal()> to ensure that
+it is disposed of correctly. If you have cached your return value, then
+return a pointer to it without changing the reference count.
 
 =head1 Caching