Bug#839167: perl: pod2man generates empty man page when pod file begins with =begin pod

[gregor herrmann]

On Thu, 29 Sep 2016 19:39:43 +0200, Dominique Dumont wrote:

> Unfortunately, pod2man from perl 5.24 generates empty man page when pod file begins with =begin pod.
> This worked fine with perl 5.22
> 
> To reproduce:
> 
> $ wget https://anonscm.debian.org/cgit/pkg-rakudo/pkg-rakudo.git/plain/docs/running.pod
> $ pod2man running.pod | nroff -man
> 
> Only the header and footer are shown

It's not only pod2man:

  % perldoc docs/running.pod 
  Got a 0-length file from docs/running.pod via Pod::Perldoc::ToTerm!?

   at /usr/bin/perldoc line 13.


  % podlint docs/running.pod
  begin expected a terminating end at docs/running.pod line 3
  over expected a terminating back at docs/running.pod line 144
  unexpected end at docs/running.pod line 151

The second line is a separate problem, also shown by:

  % podchecker docs/running.pod
  *** ERROR: =over on line 117 without closing =back (at head1) at line 144 in file docs/running.pod
  docs/running.pod has 1 pod syntax error.

but fixing it doesn't change the begin/end problem and the empty
output.


Cheers,
gregor

-- 
 .''`.  Homepage https://info.comodo.priv.at/ - OpenPGP key 0xBB3A68018649AA06
 : :' : Debian GNU/Linux user, admin, and developer -  https://www.debian.org/
 `. `'  Member of VIBE!AT & SPI, fellow of the Free Software Foundation Europe
   `-   NP: Leonard Cohen: The Partisan
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 931 bytes
Desc: Digital Signature
URL: <http://lists.alioth.debian.org/pipermail/perl-maintainers/attachments/20160929/820367e0/attachment.sig>