Re: A wishlist for CPAN
Jeremiah C. Foster dijo [Tue, Mar 04, 2008 at 11:50:32AM +0100]:
> Hello!
>
> What if we could have a "wishlist" that we could present to CPAN module
> authors? What would that contain? What would make life easier for those
> who package CPAN modules for debian?
>
> I can think of some things, like "sane versioning" that gregor mentioned,
> this would clearly help in crafting an effective watch file. Are there other
> things we would like to see?
Make sure your POD documentation makes sense when translated with
pod2man. I went several times, i.e., over all of PDF::API2's manpages
because they used "=head1 PDF::API2::Some::Thing" instead of "=head1 NAME".
Those bugs take a _lot_ of time to properly patch!
POD is not just to be used by perldoc.
--
Gunnar Wolf - gwolf@gwolf.org - (+52-55)5623-0154 / 1451-2244
PGP key 1024D/8BB527AF 2001-10-23
Fingerprint: 0C79 D2D1 2C4E 9CE4 5973 F800 D80E F35A 8BB5 27AF
Reply to: