no deprecation warning for L<section>
[email protected] (Karl Williamson)
| Newsgroups | perl.pod-people |
|---|---|
| Message-ID | <[email protected]> |
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?