Main pod in CPAN module

Do you have a question? Post it now! No Registration Necessary.  Now with pictures!

Threaded View


Last time I updated my ClearCase::Wrapper::MGi module on CPAN, I made
one unfortunate error which had a result surprisiing to me: I added
one new pod file in the extra directory, named Configuration.pod.

My main documentation page is generated from the file, in the
top directory, and had been linked so far (i.e. until v 0.20) to the
ClearCase::Wrapper::MGi module line. E.g.:

Somehow, because of alphanumeric sorting order I presume,
Configuration.pod took over in:

In this page, clicking on ClearCase::Wrapper::MGi opens:

instead of the intended

So, what did I do wrong (failed to read what instructions), and how to
fix this properly in 0.22?


Re: Main pod in CPAN module

Quoted text here. Click to load it

This file contains

    =head1 NAME

    ClearCase::Wrapper::MGi Configuration

Since this is in the same form as the standard

    =head1 NAME

    Module::Name ABSTRACT is assuming it is the documentation for CC::W::MGi.

The solution is to change that NAME section, probably to

    =head1 NAME

    ClearCase::Wrapper::MGi::Configuration - Configuration for CC::W::MGi

or some such.


Re: Main pod in CPAN module

Quoted text here. Click to load it

Thanks Ben!
I completely missed it, obvious as it is after you wrote it...


Site Timeline