Where do I report this bug?

This conversation is in [rt.cpan.org #58136] Perldoc::Toman.pm broken
because pod2man doesn't exist - I'm asking if the "part A" I'm telling
him needs done needs reported here (as a rt.perl.org ticket,
eventually), to Russ Albery (as a separate rt.cpan.org ticket), or both.

Feel free to comment here and/or on the ticket. (It's a Strawberry
ticket already, so please don't say "It needs to be reported to
Perl-Dist-Strawberry"!)

Thanks, Curtis

On Fri Jun 04 12:40:51 2010, squidevil wrote:
> Strawberry Perl 5.12.0
> This is perl 5, version 12, subversion 0 (v5.12.0) built for
> MSWin32-x86-multi-thread
> windows32 jerbraun-dev 2.6.1 7600 i686-pc Intel unknown MinGW
> 
> I have PERLDOC set to: -n "groff.exe -E -mtty-char -Tascii -P-c"
> perldoc MODULENAME used to work great, but now fails with:
>    Error while formatting with Pod::Perldoc::ToMan:
>     Can't find a pod2man?! (pod2man)
>    Aborting at C:/Strawberry/perl/lib/Pod/Perldoc/Toman.pm line 59.
> If you create c:/Strawberry/perl/bin/pod2man from pod2man.bat, then this
> works great.
> 
> So either Perldoc.pm needs to be changed to look for pod2man.bat on
> windows, or Strawberry Perl should probably just distribute a pod2man
> next to pod2man.bat.
> 
> The same is probably true of the other pod2*.bat utilities as well.

Here's the deal: The perl interpreter's build process is not copying the
pod2* files over, apparently. They're not in perl/lib/.packlist.

If Pod::Text did not need updated, (which installs updated versions of
the pod2* scripts, then creates pod2*.bat files from them) then we have
the conditions for this bug.  Strawberry Perl's build process checks for
any "dual-life" distributions that need updated, so 5.10.x versions of
Strawberry Perl won't have this bug, but 5.12.x versions will.

"cpan> force install Pod::Text" should fix the problem for you.

Three things need done in the future.

1) WORKAROUND: Strawberry should force the installation of the podlators
dist.
2) Part A: p5p (the people that maintain the perl source itself) or the
podlators maintainer (will have to ask which one of these two applies)
needs told that this is happening so they can fix this in perl itself.
3) Part B: Pod::Perldoc needs updated to look for pod2*.bat.
--
Curtis Jewell
csjewell@cpan.org           http://csjewell.dreamwidth.org/
perl@csjewell.fastmail.us   http://csjewell.comyr.org/perl/

"Your random numbers are not that random" -- perl-5.10.1.tar.gz/util.c

Strawberry Perl for Windows betas: http://strawberryperl.com/beta/

• Where do I report this bug? by Curtis Jewell
• RE: Where do I report this bug? by Jan Dubois