Paul,
 
I just pushed a few minuts ago a new script in misc (bug 8376, but it
doesn't matter for this mail)

This script has a help that is displayed when you run it with -h. So far
so good.

BUT, it has no PODDOC. Not so good.

I've discovered recently that we could use:
> use Pod::Usage;
>
> sub usage {
>     pod2usage( -verbose => 2 );
>     exit;
> }
> <snip>
> usage() if $help;

That will deal with both POD and -h flag. It's used in some scripts like
misc/maintenance/touch_all_biblios.pl

Do we agree it's a good idea to request that for future scripts, and add
this in the coding guidelines ?

+1 from me

Regards,
Jared
 
--
Jared Camins-Esakov
Bibliographer, C & P Bibliography Services, LLC
(phone) +1 (917) 727-3445
(e-mail) jcamins@cpbibliography.com
(web) http://www.cpbibliography.com/