[perl #116945] Documentation on $obj->foo::bar(…) missing from 5.16 perlobj

# New Ticket Created by  Julian Bean 
# Please include the string:  [perl #116945]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org:443/rt3/Ticket/Display.html?id=116945 >


Hi,

The documentation for the particular form of method invocation where you specify a package name to begin the dispatch at:

$obj->foo::bar(….)

was present in perlobj(1) up until 5.14 ( see https://github.com/mirrors/perl/blob/maint-5.14/pod/perlobj.pod ) with an example 

$barney->Critter::display("Height", "Weight");

It seems that perlobj got rewritten in 5.16 branch and this part of the file has changed, completely removing all mention of that feature. I think it deserves a mention not least because there are modules on CPAN which use this style as their api. Ideally the paragraph would also mention that you can start dispatch at an arbitrary package not necessarily in the MRO of the object.

Thanks,

Jules

PS Nicholas told me to mention soup.

• [perl #116945] Documentation on $obj->foo::bar(…) missing from 5.16 perlobj by James E Keenan via RT
• [perl #116945] Documentation on $obj->foo::bar(…) missing from 5.16 perlobj by Julian Bean