From: Paul Fenwick <pjf@perltraining.com.au>
Date: Tue, 24 Jun 2008 13:53:19 +0000 (+1000)
Subject: Documentation on taint/environment interactions for perlrun.pod
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=5437faeb38953534d8279237269351e73eca7351;p=p5sagit%2Fp5-mst-13.2.git

Documentation on taint/environment interactions for perlrun.pod
Message-ID: <48606FAF.4040604@perltraining.com.au>

p4raw-id: //depot/perl@34081
---

diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index a8458a8..2a53ec7 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -1093,6 +1093,9 @@ compiler's numeric file descriptor routines. There is an experimental native
 C<win32> layer which is expected to be enhanced and should eventually be
 the default under Win32.
 
+The PERLIO environment variable is completely ignored when perl
+is run in taint mode.
+
 =item PERLIO_DEBUG
 X<PERLIO_DEBUG>
 
@@ -1117,6 +1120,9 @@ A list of directories in which to look for Perl library
 files before looking in the standard library and the current directory.
 If PERL5LIB is defined, PERLLIB is not used.
 
+The PERLLIB environment variable is completely ignored when perl
+is run in taint mode.
+
 =item PERL5DB
 X<PERL5DB>
 
@@ -1124,6 +1130,9 @@ The command used to load the debugger code.  The default is:
 
 	BEGIN { require 'perl5db.pl' }
 
+The PERL5DB environment variable only used when perl is started with
+a bare B<-d> switch.
+
 =item PERL5DB_THREADED
 X<PERL5DB_THREADED>
 
@@ -1146,6 +1155,11 @@ fit for interactive use, and setting COMSPEC to such a shell may
 interfere with the proper functioning of other programs (which usually
 look in COMSPEC to find a shell fit for interactive use).
 
+Before Perl 5.10.0 and 5.8.8, PERL5SHELL was not taint checked
+when running external commands.  It is recommended that
+you explicitly set (or delete) C<$ENV{PERL5SHELL}> when running
+in taint mode under Windows.
+
 =item PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
 X<PERL_ALLOW_NON_IFS_LSP>