Google Groups no longer supports new Usenet posts or subscriptions. Historical content remains viewable.
Dismiss
podlators 4.06 released
2 views
Skip to first unread message
Russ Allbery
Jan 31, 2016, 11:30:01 PM1/31/16
to pod-p...@perl.org, perl5-...@perl.org
I'm pleased to announce release 4.06 of podlators.
podlators contains Pod::Man and Pod::Text modules which convert POD input
to *roff source output, suitable for man pages, or plain text. It also
includes several subclasses of Pod::Text for formatted output to terminals
with various capabilities. It is the source package for the Pod::Man and
Pod::Text modules included with Perl.
Changes from previous release:
Handle scripts ending in .com on VMS systems and don't generate the
man page for perlpodstyle when built as part of Perl core. These are
hopefully the last two changes required to fully merge with Perl core
without core having to maintain a separate build system. Thanks,
Craig A. Berry.
During build, generate the pod2text and pod2man man pages from the
*.PL files rather than the generated scripts. This may be required
due to the different script extensions on VMS hosts.
Rename perlpodstyle back to perlpodstyle.pod, since we no longer need
the workaround for Module::Build's POD handling.
You can download it from:
<http://www.eyrie.org/~eagle/software/podlators/>
This package is maintained using Git; see the instructions on the above
page to access the Git repository.
Please let me know of any problems or feature requests not already listed
in the TODO file.
--
#!/usr/bin/perl -- Russ Allbery, Just Another Perl Hacker
$^=q;@!>~|{>krw>yn{u<$$<[~||<Juukn{=,<S~|}<Jwx}qn{<Yn{u<Qjltn{ > 0gFzD gD,
00Fz, 0,,( 0hF 0g)F/=, 0> "L$/GEIFewe{,$/ 0C$~> "@=,m,|,(e 0.), 01,pnn,y{
rw} >;,$0=q,$,,($_=$^)=~y,$/ C-~><@=\n\r,-~$:-u/ #y,d,s,(\$.),$1,gee,print
podlators contains Pod::Man and Pod::Text modules which convert POD input
to *roff source output, suitable for man pages, or plain text. It also
includes several subclasses of Pod::Text for formatted output to terminals
with various capabilities. It is the source package for the Pod::Man and
Pod::Text modules included with Perl.
Changes from previous release:
Handle scripts ending in .com on VMS systems and don't generate the
man page for perlpodstyle when built as part of Perl core. These are
hopefully the last two changes required to fully merge with Perl core
without core having to maintain a separate build system. Thanks,
Craig A. Berry.
During build, generate the pod2text and pod2man man pages from the
*.PL files rather than the generated scripts. This may be required
due to the different script extensions on VMS hosts.
Rename perlpodstyle back to perlpodstyle.pod, since we no longer need
the workaround for Module::Build's POD handling.
You can download it from:
<http://www.eyrie.org/~eagle/software/podlators/>
This package is maintained using Git; see the instructions on the above
page to access the Git repository.
Please let me know of any problems or feature requests not already listed
in the TODO file.
--
#!/usr/bin/perl -- Russ Allbery, Just Another Perl Hacker
$^=q;@!>~|{>krw>yn{u<$$<[~||<Juukn{=,<S~|}<Jwx}qn{<Yn{u<Qjltn{ > 0gFzD gD,
00Fz, 0,,( 0hF 0g)F/=, 0> "L$/GEIFewe{,$/ 0C$~> "@=,m,|,(e 0.), 01,pnn,y{
rw} >;,$0=q,$,,($_=$^)=~y,$/ C-~><@=\n\r,-~$:-u/ #y,d,s,(\$.),$1,gee,print
Russ Allbery
Feb 16, 2016, 1:45:02 PM2/16/16
to Dave Mitchell, pod-p...@perl.org, perl5-...@perl.org
Dave Mitchell <da...@iabyn.com> writes:
> Since that's been pulled into blead, I'm seeing these warnings on parallel
> blead builds:
> utf8 mode requested but Encode module not available, falling back to non-utf8 at /home/davem/perl5/git/bleed/cpan/ExtUtils-MakeMaker/lib/ExtUtils/Command/MM.pm line 145.
> utf8 mode requested but Encode module not available, falling back to non-utf8 at /home/davem/perl5/git/bleed/cpan/ExtUtils-MakeMaker/lib/ExtUtils/Command/MM.pm line 145.
> Basically when blead is building podlators, it may not have yet finished
> building Encode. (The warning is actually being generated by the carp
> at cpan/podlators/lib/Pod/Man.pm:151.)
> I don't know whether this is harmless or not. If harmless, it would be
> nice to be able to silence this warning in some fashion. If harmful, we
> should fix it in some fashion.
It's harmless *as long as* all man pages are generated later after all the
modules are available. It's also currently harmless without other patches
because right now man page generation in core is very conservative and
doesn't produce UTF-8 output.
However, I do want to change the latter at some point so that we can
properly represent non-ASCII characters in man page output. If any of the
man pages generated by podlators during the stage where these warnings are
generated are actually kept, they'll break later.
My preferred solution would be to require Encode as a prerequisite for
podlators when building core. Is there any way to do that?
> Since that's been pulled into blead, I'm seeing these warnings on parallel
> blead builds:
> utf8 mode requested but Encode module not available, falling back to non-utf8 at /home/davem/perl5/git/bleed/cpan/ExtUtils-MakeMaker/lib/ExtUtils/Command/MM.pm line 145.
> utf8 mode requested but Encode module not available, falling back to non-utf8 at /home/davem/perl5/git/bleed/cpan/ExtUtils-MakeMaker/lib/ExtUtils/Command/MM.pm line 145.
> Basically when blead is building podlators, it may not have yet finished
> building Encode. (The warning is actually being generated by the carp
> at cpan/podlators/lib/Pod/Man.pm:151.)
> I don't know whether this is harmless or not. If harmless, it would be
> nice to be able to silence this warning in some fashion. If harmful, we
> should fix it in some fashion.
It's harmless *as long as* all man pages are generated later after all the
modules are available. It's also currently harmless without other patches
because right now man page generation in core is very conservative and
doesn't produce UTF-8 output.
However, I do want to change the latter at some point so that we can
properly represent non-ASCII characters in man page output. If any of the
man pages generated by podlators during the stage where these warnings are
generated are actually kept, they'll break later.
My preferred solution would be to require Encode as a prerequisite for
podlators when building core. Is there any way to do that?
Russ Allbery
Mar 20, 2016, 7:30:01 PM3/20/16
to Dave Mitchell, pod-p...@perl.org, perl5-...@perl.org
Dave Mitchell <da...@iabyn.com> writes:
> But I don't think its necessary after all: the new() method in Pod::Man
> is only called in three places during the build:
> 1. Building cpan/podlators.
> At this point Encode isn't built, and the warning is emitted
> 2. Testing cpan/podlators/t/*/*.t
> At this point Encode is built and there are no warnings.
> 3. Installing perl and all its modules
> It's called many times here, but again, at this point Encode is built so
> there are no warnings
> Only during (1) is the environment variable PERL_CORE set.
> Unless there's a need for Encode to be present when padlators is made,
> I propose that the code in Pod::Man::new() which warns if Encode isn't
> present, only does so if !$ENV{PERL_CORE}.
This is a great idea. Thanks! Now implemented, and will be in the next
podlators release (probably later today).
--
Russ Allbery (ea...@eyrie.org) <http://www.eyrie.org/~eagle/>
> But I don't think its necessary after all: the new() method in Pod::Man
> is only called in three places during the build:
> 1. Building cpan/podlators.
> At this point Encode isn't built, and the warning is emitted
> 2. Testing cpan/podlators/t/*/*.t
> At this point Encode is built and there are no warnings.
> 3. Installing perl and all its modules
> It's called many times here, but again, at this point Encode is built so
> there are no warnings
> Only during (1) is the environment variable PERL_CORE set.
> Unless there's a need for Encode to be present when padlators is made,
> I propose that the code in Pod::Man::new() which warns if Encode isn't
> present, only does so if !$ENV{PERL_CORE}.
This is a great idea. Thanks! Now implemented, and will be in the next
podlators release (probably later today).
--
Russ Allbery (ea...@eyrie.org) <http://www.eyrie.org/~eagle/>
0 new messages