This is one of those bits of syntax that, I think, almost nobody really knows about -- and that those who do wish they didn't.
We all know L<Document/Section> and L</Section>. These can both also be written as L<Document/"Section"> and L</"Section">, which I guess is fine, although sort of pointless. That's not the gross case. The grossest case is L<Section> which is totally unambiguous and was (hooray) deprecated in perlpodspec in 2001. The sort of utterly insane (but less ambiguous) case is L<"Section"> which is equivalent to L</"Section"> In other words: L<Foo::Bar> links to Foo::Bar but L<"Foo::Bar"> links to the section Foo::Bar in the current document. The meaning of L<"Foo::Bar"/"Foo::Bar"> is left as an exercise to the reader. I propose to remove mention of L<"Section"> from perlpod and to deprecate it in perlpodspec, and also to reword the mention of L<Section> in perlpodspec to make it less optional and more dead. I'll probably do this in the next few days, and will look to get this and last night's discussed changes merged after 5.12. Thoughts? -- rjbs
