Document %ENV = () portability issues.

p4raw-id: //depot/perl@7580

1 files changed, 6 insertions, 0 deletions

diff --git a/vms/perlvms.pod b/vms/perlvms.pod
index 17e83e5c1b..25058bc902 100644
--- a/vms/perlvms.pod
+++ b/vms/perlvms.pod
@@ -788,6 +788,12 @@ by saying
 (You can't just say C<$ENV{$key} = $ENV{$key}>, since the
 Perl optimizer is smart enough to elide the expression.)
 
+Don't try to clear C<%ENV> by saying C<%ENV = ();> Bad things will
+happen because parts of C<%ENV> are per-process, parts of it are
+per-group, and parts of it are system-wide.  Without some serious
+rights, it won't work, or with the rights, it does, but the system
+will effectively die.
+
 At present, the first time you iterate over %ENV using
 C<keys>, or C<values>,  you will incur a time penalty as all
 logical names are read, in order to fully populate %ENV.