FAQ
Hi all,

I have patched Pod::Perldoc (3.15, latest CPAN and blead version) by
adding some features and fixed several bugs regarding POD2 translation
packages integration.

In particular:

* "PERLDOC_POD2" environment variable could be used, to set once, the
preferred translation (instead of using "-L" switch each time). For
example with:

export PERLDOC_POD2=it

perldoc will use POD2::IT translations (if there are, english to default).
If "PERLDOC_POD2=1", the language code will be auto-retrieved from
locale, that is,
from "LC_ALL" "LC_LANG" "LANG" environment variables respectively (I
don't know if is the right order).
For example with:

export PERLDOC_POD2=1

perldoc will use POD2::FR translations (if there are, english to
default) assuming "LC_ALL=fr_FR" on your machine.

(Note that "-L" switch overrides "PERLDOC_POD2" settings).

* bug fix: -f switch works correctly with missing translations. For
example 'perldoc -L pt -f ' retrieves the standard (English) version
if it cannot find the Portuguese translation.

* bug fix: perldoc now correctly works with several translators (f.e.
perldoc -L "it fr").

Best

- Enrico

PS: I omitted patches for doc and changes files

Search Discussions

  • Steffen Mueller at Sep 30, 2009 at 8:15 am
    Hi Enrico,

    sorry for the delay in replying.

    Enrico Sorcinelli wrote:
    I have patched Pod::Perldoc (3.15, latest CPAN and blead version) by
    adding some features and fixed several bugs regarding POD2 translation
    packages integration.
    I went ahead and applied your patch with change
    ad92440e4e7d7fcf84e99c11ae560b427583b796.
    PS: I omitted patches for doc and changes files
    Cold you send a quick patch for the docs at least? Maybe even a test?

    Best regards,
    Steffen

    PS: While I'm personally quite comfortable with English, I think the
    work you're doing with translations is important to lower the barrier to
    entry to the language. Thank you for that!

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupperl5-porters @
categoriesperl
postedSep 9, '09 at 6:25p
activeSep 30, '09 at 8:15a
posts2
users2
websiteperl.org

People

Translate

site design / logo © 2021 Grokbase