I was reading podspec, and saw this
Previous versions of perlpod allowed for a "L<section>" syntax (as in
"L<Object Attributes>"), which was not easily distinguishable from
"L<name>" syntax and for "L<"section">" which was only slightly less
ambiguous. This syntax is no longer in the specification, and has been
replaced by the "L</section>" syntax (where the slash was formerly
optional). Pod parsers should tolerate the "L<"section">" syntax, for a
while at least. The suggested heuristic for distinguishing "L<section>"
from "L<name>" is that if it contains any whitespace, it's a section.
Pod processors should warn about this being deprecated syntax.
I notice that perldoc does not warn on this being deprecated. Is this
by design?
