develooper Front page | perl.perl5.porters | Postings from March 2001

yet more pod questioning

Thread Next
Michael Stevens
March 4, 2001 10:02
yet more pod questioning
Message ID:

I'm  still trying to understand pod and podchecker.

podchecker will warn on this:

  =head1 FOO


  =item FOO

in the same document. The docs say this is because multiple identical
nodes make links to that target within the page ambiguous.

But perlpod documents L<page/item> for an item in a man page, and
L<page/"section"> for a section in a man page. Suggesting that the
above *isn't* ambiguous, because there are different syntaxes for
pointing at an item and a section.

But if you want a section in the same page, you're supposed to use L<"section">
with optional quotes (again from perlpod), suggesting that items and heads
ARE in the same space.

I'm confused. What's all going on?

(the reason I bring all this up is because the perl docs trigger this
warning rather a lot)


Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About