Giters

plu / Pithub

Perl Github v3 API

Home Page:http://metacpan.org/module/Pithub

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Problem with POD generation

gregoa opened this issue · comments

commented

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 c4d05b1 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

commented

@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
commented