| Date: | Fri, 6 Jan 2006 18:20:06 -0500 |
| From: | Daniel Macks <dmacks [...] netspace.org> |
| To: | bug-Pod-Parser [...] rt.cpan.org |
| Subject: | Same =item in sublist of different =item |
Pod::Checker explains one of its warnings:
* multiple occurrence of link target name
The POD file has some "=item" and/or "=head" commands that have the
same text. Potential hyperlinks to such a text cannot be unique then.
How does this get applied to nested =item lists such as (blank lines
omitted for brevity):
=over 4
=item Item 1
=over 4
=item Subitem a
=back
=back
Would the link be to "Subitem a" or "Subitem a of Item 1"? Reason I
ask is that this warning appears if I have a single occurance of
"Subitem a" in each of "Item 1" and "Item 2":
=over 4
=item Item 1
=over 4
=item Subitem a
=back
=item Item 2
=over 4
=item Subitem a
=back
=back
That seems like a legitimate usage (parameter lists for a list of
functions, for example). I'm using podchecker and related modules from
perl5.8.6.