For "L<...>" codes without a "name|" part, only "E<...>" and "Z<>" codes may occur -- no other formatting codes. That is, authors should not use ""L<B<Foo::Bar>>"".
Yes, I wrote this too narrowly -- I said For "L<...>" codes without a "name|" part but I meant For "L<url>" codes and "L<Some::Module>" codes (without a "name|" part)
That note is basically a reaction to Pod::Tree's bad idea that L<C<Foo::Bar>> should mean L<C<Foo::Bar>|Foo::Bar>.
(Is L<B<Foo::Bar>> legal if it's a link to =head1 B<Foo::Bar>?)
Now that you meantion it, yes it is; I hadn't been considering the L<section name> syntax (instead of L</"section name"> or L</section name> or L<"section name">).
-- Sean M. Burke http://search.cpan.org/~sburke/
