I noticed something very confusing in perldoc -m UNIVERSAL (in perl 5.8.0) There seems to be some contradictions. In the explanation of

$obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE )
[download]

it gives the example:

   use UNIVERSAL qw( isa ) ;
   $yes = isa $h, "HASH";
   $yes = isa "Foo", "Bar";
[download]

but then at the bottom of the page it says:

These subroutines should not be imported via use UNIVERSAL qw(...). 
If you want simple local access to them you can do

  *isa = \&UNIVERSAL::isa;

to import isa into your package.
[download]

which contradicts the example. Has this been pointed out to the Doc maintainer? I've never submitted anything using perlbug and I don't know how to do an exhaustive search of the perl bug tracking mechanism. I don't want to waste anyone's time if it is a known mistake.

--

flounder