From: Ricardo Signes <rjbs@cpan.org>
Date: Mon, 7 Dec 2009 23:21:44 +0000 (-0500)
Subject: more aggressively deprecate L<section> and L<"section">
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=b41aadf259cf55858c5ab0386356cdbe2dc49a6b;p=p5sagit%2Fp5-mst-13.2.git

more aggressively deprecate L<section> and L<"section">
---

diff --git a/pod/perlpod.pod b/pod/perlpod.pod
index 5e2121d..55ea57e 100644
--- a/pod/perlpod.pod
+++ b/pod/perlpod.pod
@@ -395,7 +395,7 @@ C<LE<lt>perlsyn/"For Loops"E<gt>>
 
 =item *
 
-C<LE<lt>/"sec"E<gt>> or C<LE<lt>/secE<gt>> or C<LE<lt>"sec"E<gt>>
+C<LE<lt>/"sec"E<gt>> or C<LE<lt>/secE<gt>>
 
 Link to a section in this manual page.  E.g.,
 C<LE<lt>/"Object Methods"E<gt>>
diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod
index 537f29a..761b1bb 100644
--- a/pod/perlpodspec.pod
+++ b/pod/perlpodspec.pod
@@ -1340,15 +1340,16 @@ given C<LE<lt>fooE<gt>> code.
 
 =item *
 
-Previous versions of perlpod allowed for a C<LE<lt>sectionE<gt>> syntax
-(as in C<LE<lt>Object AttributesE<gt>>), which was not easily distinguishable
-from C<LE<lt>nameE<gt>> syntax.  This syntax is no longer in the
-specification, and has been replaced by the C<LE<lt>"section"E<gt>> syntax
-(where the quotes were formerly optional).  Pod parsers should tolerate
-the C<LE<lt>sectionE<gt>> syntax, for a while at least.  The suggested
-heuristic for distinguishing C<LE<lt>sectionE<gt>> from C<LE<lt>nameE<gt>>
-is that if it contains any whitespace, it's a I<section>.  Pod processors
-may warn about this being deprecated syntax.
+Previous versions of perlpod allowed for a C<LE<lt>sectionE<gt>> syntax (as in
+C<LE<lt>Object AttributesE<gt>>), which was not easily distinguishable from
+C<LE<lt>nameE<gt>> syntax and for C<LE<lt>"section"E<gt>> which was only
+slightly less ambiguous.  This syntax is no longer in the specification, and
+has been replaced by the C<LE<lt>/sectionE<gt>> syntax (where the slash was
+formerly optional).  Pod parsers should tolerate the C<LE<lt>"section"E<gt>>
+syntax, for a while at least.  The suggested heuristic for distinguishing
+C<LE<lt>sectionE<gt>> from C<LE<lt>nameE<gt>> is that if it contains any
+whitespace, it's a I<section>.  Pod processors should warn about this being
+deprecated syntax.
 
 =back