develooper Front page | perl.pod2 | Postings from October 2009

Re: [ANNOUNCE] pod2.perl.org!

Thread Previous
From:
Adriano Ferreira
Date:
October 7, 2009 06:25
Subject:
Re: [ANNOUNCE] pod2.perl.org!
Message ID:
73ddeb6c0910070625q479157eek853e60433fe304d2@mail.gmail.com
On Wed, Oct 7, 2009 at 9:30 AM, Enrico Sorcinelli <
enrico.sorcinelli@gmail.com> wrote:

> Hi Joergen,
>
> 2009/10/7 Joergen W. Lang <joergen_lang@gmx.de>:
> >
> >
> > Enrico Sorcinelli schrieb:
> >>
> >> Hi Joergen,
> >>
> >> 2009/10/6 Joergen W. Lang <joergen_lang@gmx.de>:
> >>>
> >>> Congratulations!!!
> >>
> >> Thanks :-)
> >>
> >> I hope to see you also in pod2@perl.org mailing list:
> >
> > I just subscribed. That process should be *much* easier.
>
> BTW, all @perl.org lists are running with ezmlm. There is no web
> interface at all :-(
>
> >> there are a lot
> >> of good things in your perldoc2 specifications that IMHO we should
> >> resume and I think that your help will be important.
> >
> > Browsing through the initial page on pod2.perl.org I found the
> following:
> >
> > %> perldoc -L <country_code> perl
> >
> > May I suggest:
> >
> > %> perldoc perl
> >
> > defaults to whatever language is set in $ENV{'LANG'}. If no translation
> is
> > available an automatic fallback to english could take place.
>
> I already sent a similar patch to perl5-porters (seems that it has
> been applied, see
> http://www.nntp.perl.org/group/perl.perl5.porters/2009/09/msg150799.html)
> the improve Pod::Perldoc in that sense. That is, with PERLDOC_POD2
> environment variabile you can set (once) preferred language or use
> language set in LC_ALL" "LC_LANG" "LANG" environment variables
> respectively.
>

Yes, this is right now in bleadperl and in CPAN developer release 3.15_01 (
http://search.cpan.org/dist/Pod-Perldoc-3.15_01/) which is just a
synchronization of the module code with the perl5-porters code.


>
> > Also: Default encoding should be UTF8 (16?). Existing pages should be
> > converted.
> > What do you think?
>
>
Because of the current status of the Pod processors based on Pod::Simple,
the UTF8 encoding is preferred. For example, search.cpan.org handles it
well. And for the record, you can try and see how your documents will look
like in search.cpan.org by going through its special Pod-to-HTML processor
available in this page: http://search.cpan.org/pod2html

Adriano

Thread Previous


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About