List Info

Thread: lib/Pod/Perldoc.pm - make -L more forgiving




lib/Pod/Perldoc.pm - make -L more forgiving
user name
2007-08-23 13:37:13
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

  
Re: lib/Pod/Perldoc.pm - make -L more forgiving
user name
2007-08-30 03:51:59
On 23/08/2007, Adriano Ferreira <a.r.ferreiragmail.com> wrote:
> 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.

Thanks, applied as #31762, plus a typo fixed in #31763.

[1-2]

about | contact  Other archives ( Real Estate discussion Medical topics )