Front page | perl.perl5.porters |
Postings from March 2001
yet more pod questioning
Thread Next
From:
Michael Stevens
Date:
March 4, 2001 10:02
Subject:
yet more pod questioning
Message ID:
20010304180244.A30180@firedrake.org
Hi.
I'm still trying to understand pod and podchecker.
podchecker will warn on this:
=head1 FOO
and
=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)
Michael
Thread Next
-
yet more pod questioning
by Michael Stevens