Hi all, after almost two years from RFC, italian Perl users (finally!) published a large part of translated core Perl pods (including perlfunc and perlfaq*) into the package POD2::IT where 'IT' is the language code. This has been (and currently still is) a very impressive work! :-)
Once the package has been installed, the translated documentation can be
accessed with:
%> perldoc POD2::IT::<podname>
However the -f and -q swithces don't work no longer.
So, I've attached the patch to Pod/Perldoc.pm in order to allow also the
syntax:
%> perldoc -L IT <podname>
%> perldoc -L IT -f <function>
%> perldoc -L IT -q <FAQregex>
I added a -L switch that allow to define language code for desired language
translation. If POD2::<code> package doesn't exists, the effect of the switch
will be ignored.
Since 'search_perlfunc' uses hard coded string 'Alphabetical Listing of Perl
Functions' to skip introduction, in order to make to work it with other
languages with the option -L, I used a simple plugin-like mechanism.
POD2::<code> language package must export 'search_perlfunc_re' that returns a
localized translation of the paragraph string. This string will be used to skip
perlfunc intro.
Again, if POD2::<code>->search_perlfunc_re fails (or doesn't exist), we'll come
back to the default behavoiur.
This plugin-like mechanism allows to add additional POD2::* translations without
need to patch Perldoc.pm every time.
What do you think?
Regards
- Enrico
Perldoc.pm-3.14-patch
Description: Binary data
