Pithub icon indicating copy to clipboard operation
Pithub copied to clipboard

Problem with POD generation

Open gregoa opened this issue 7 years ago • 2 comments

The generated POD in the tarball on CPAN for Pithub::Base has some issues. perldoc complains about missing and additional =backs. What seems to happen is that the sections marked with =for Pod::Coverage in commit c4d05b1dc4b905d4c44ee0db7522237e44f4572a don't end up in their proper place but close to the very bottom of the file. This can be seen at https://metacpan.org/source/OALDERS/Pithub-0.01034/lib/Pithub/Base.pm

gregoa avatar Mar 17 '18 20:03 gregoa

@gregoa thanks for this. I still haven't gotten to the root of the issue.

[12:36:47]  <oalders>	Does anyone know what I did wrong here? https://github.com/plu/Pithub/issues/209
[12:41:13]  <mst>	attempted to use a computer for something it was designed for
[12:41:39]  <oalders>	:)
[12:41:45]  <oalders>	Looks like there are Pod errors listed here https://metacpan.org/pod/Pithub::Base
[12:41:51]  <oalders>	I should have checked that first.
[12:42:45]  <mst>	I would imagine it's Pod::Weaver trying to be clever and getting confused?
[13:27:44]  <Grinnz>	you're missing several =backs at the end of lists, and =for/=back is not a thing, =for is jsut a single line, you want =begin/=end
[13:27:50]  <Grinnz>	single paragraph*
[13:28:27]  <Grinnz>	ah, thats generated, dunno then
[13:47:38]  <mst>	the original source doesn't seem wrong
[13:47:45]  <mst>	so I'm *guessing* it's dzil being clever

oalders avatar Mar 19 '18 14:03 oalders

On Mon, 19 Mar 2018 14:34:51 +0000, Olaf Alders wrote:

@gregoa thanks for this. I still haven't gotten to the root of the issue.

Thanks for looking into this glitch! Unfortunately I have hardly any clue about dzl or Pod::Weaver, so I won't be much help.

Cheers, gregor

-- .''. https://info.comodo.priv.at -- Debian Developer https://www.debian.org : :' : OpenPGP fingerprint D1E1 316E 93A7 60A8 104D 85FA BB3A 6801 8649 AA06 . ' Member VIBE!AT & SPI Inc. -- Supporter Free Software Foundation Europe - NP: Rebekka Bakken & Wolfgang Muthspiel: Nowhere

gregoa avatar Mar 20 '18 21:03 gregoa