I waiting for thumbs-up from Pod::Perldoc maintainers about becoming
yet another maintainer for this module as well.

For reference, I released development releases 3.14_01 and 3.14_02 to
CPAN (which were marked UNAUTHORIZED) because I don't have credentials
for official releases yet.

3.14_01 - applies the bleedperl changes that separate the current CPAN
version (3.14) and the code released with 5.9.5 and which is going to
be shipped with 5.10

3.14_02 - makes -L more forgiving (according to the message and patch
below, just sent to perl5-porters)

Any comments will be welcome.

Regards,
Adriano Ferreira

---------- Forwarded message ----------
From: Adriano Ferreira <[EMAIL PROTECTED]>
Date: Aug 23, 2007 3:37 PM
Subject: [PATCH] lib/Pod/Perldoc.pm - make -L more forgiving
To: [EMAIL PROTECTED]


The recently introduced switch -L started an effort to support for
reading Perl documentation in other languages but English via the
standard utility "perldoc". The CPAN related projects that are more
advanced are POD2::IT and POD2::FR (respectively, the Italian and the
French translation).

The patch that introduced the switch " -L language_code " took care of
ignoring the option if the corresponding module was not installed.

But (after installed)

$ perldoc -L it perlintro

works because there is a translated perlintro.pod, while

$ perldoc -L it perldoc

does not. I don't think the following message

No documentation found for "POD2::IT::perldoc".

is what users expect. To tell the truth, if they typed that, they
expected the Italian translation of perldoc.pod (which is not ready
yet), but I think falling back to the standard (English) page is more
useful.

The attached patch implements just this.

Regards,
Adriano Ferreira

Attachment: perldoc.diff
Description: application/txt

Reply via email to