From: Ricardo Signes <rjbs@cpan.org>
Date: Mon, 25 Nov 2013 23:18:08 +0000 (-0500)
Subject: document the deprecation of literal ctrl char varnames
X-Git-Tag: upstream/5.20.0~1124
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b50f77aa7f446f6dc9c38d466ed5a8d7e850a54e;p=platform%2Fupstream%2Fperl.git

document the deprecation of literal ctrl char varnames
---

diff --git a/pod/perldata.pod b/pod/perldata.pod
index 254884d..d8edfe9 100644
--- a/pod/perldata.pod
+++ b/pod/perldata.pod
@@ -196,11 +196,15 @@ like C<$^V> or C<$^W>, or a sigil followed by a literal control character
 matching the C<\p{POSIX_Cntrl}> property.
 Due to a historical oddity, if not
 running under C<use utf8>, the 128 extra controls in the C<[0x80-0xff]> range
-may also be used in length one variables.
+may also be used in length one variables.  The use of a literal control
+character is deprecated.  Support for this form will be removed in a future
+version of perl.
 
 =item Similar to the above, a sigil, followed by bareword text in brackets,
 where the first character is either a caret followed by an uppercase letter,
-or a literal control, like C<${^GLOBAL_PHASE}> or C<${\7LOBAL_PHASE}>.
+or a literal control, like C<${^GLOBAL_PHASE}> or C<${\7LOBAL_PHASE}>.  The use
+of a literal control character is deprecated.  Support for this form will be
+removed in a future version of perl.
 
 =item A sigil followed by a single character matching the C<\p{POSIX_Punct}>
 property, like C<$!> or C<%+>.