POD & CPAN funny

File this under….

“you learn something new every day”

My last upload of MooseX::SingletonMethod produced a funny in the module documentation (POD) on CPAN. It was showing the same POD in both modules (MX::SM & MX::SM::Role).

And not only was it showing MX::SM::Role POD in both but when you selected source you would only see code for MX::SM!?

How very odd?? (and u can still see this when u click above 0.02 link).

Here is an important snippet of how the modules / POD looked… first for MooseX::SingletonMethod:

package MooseX::SingletonMethod;

...

1;

__END__

=head1 NAME

MooseX::SingletonMethod - Moose with Singleton Method facility.

...

and for MooseX::SingletonMethod::Role

package MooseX::SingletonMethod::Role;
...
  
1;

__END__

=head1 NAME

MooseX::SingletonMethod - Role providing Singleton Method option

...

Spot the mistake?

The last line shown in above module should be….

MooseX::SingletonMethod::Role - Role providing Singleton Method option

Opps… missed off the ::Role part 😦

I thought the CPAN docs were picked up from and assigned via package declaration… obviously not! Also the POD coverage tests didn’t spot anything either (perhaps it might have done if I completely foobar the POD name! )

Anyway… all’s well that ends well 😉

/I3az/