From: Kent Fredric <kentnl@cpan.org>
Date: Sat, 15 Dec 2012 13:13:39 +0000 (+1300)
Subject: pod/perl5180delta.pod: Clarify %ENV Changes
X-Git-Tag: v5.19.2~93
X-Git-Url: https://perl5.git.perl.org/perl5.git/commitdiff_plain/f2b58637540209598dcb77ca7075309da337f4ad

pod/perl5180delta.pod: Clarify %ENV Changes

Clarifies the slightly vague ( and  possibly wrong ) explanation for the change in %ENV behaviour.
---

diff --git a/pod/perl5180delta.pod b/pod/perl5180delta.pod
index 66439413..86c4289 100644
--- a/pod/perl5180delta.pod
+++ b/pod/perl5180delta.pod
@@ -534,12 +534,16 @@ in L<perlsub/Lexical Subroutines>.
 
 =head2 Defined values stored in environment are forced to byte strings
 
-A value stored in an environment variable has always been stringified.  In this
-release, it is converted to be only a byte string.  First, it is forced to be
-only a string.  Then if the string is utf8 and the equivalent of
-C<utf8::downgrade()> works, that result is used; otherwise, the equivalent of
-C<utf8::encode()> is used, and a warning is issued about wide characters
-(L</Diagnostics>).
+A value stored in an environment variable has always been stringified when
+inherited by child processes.
+
+In this release, when assigning to C<%ENV>, values are immediately stringified,
+and converted to be only a byte string.
+
+First, it is forced to be a only a string.  Then if the string is utf8 and the
+equivalent of C<utf8::downgrade()> works, that result is used; otherwise, the
+equivalent of C<utf8::encode()> is used, and a warning is issued about wide
+characters (L</Diagnostics>).
 
 =head2 C<require> dies for unreadable files