summaryrefslogtreecommitdiff
path: root/pod/perlrun.pod
diff options
context:
space:
mode:
authorCraig A. Berry <craigberry@mac.com>2016-04-14 14:23:52 -0500
committerTony Cook <tony@develop-help.com>2016-06-08 13:48:47 +1000
commit2104c6951fdadf57c33668bc253de5ea871c9335 (patch)
tree9e965028ab7b581e9e264b323ce90c9276b678ca /pod/perlrun.pod
parent64320867983cca6494b5d7efcd95af322feacf0c (diff)
downloadperl-2104c6951fdadf57c33668bc253de5ea871c9335.tar.gz
(perl #127380) Update PERLIO_DEBUG documentation.
Now defaults to stderr if unspecified, and requires -Di (and thus -DDEBUGGING). TonyC: modify a couple of verbatim lines to bring them under the limit enforced by the new podcheck.t changes
Diffstat (limited to 'pod/perlrun.pod')
-rw-r--r--pod/perlrun.pod17
1 files changed, 10 insertions, 7 deletions
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index ecd2adfd6f..349e91e3d6 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -1155,19 +1155,22 @@ is run in taint mode.
=item PERLIO_DEBUG
X<PERLIO_DEBUG>
-If set to the name of a file or device, certain operations of PerlIO
-subsystem will be logged to that file, which is opened in append mode.
-Typical uses are in Unix:
+If set to the name of a file or device when Perl is run with the
+B<-Di> command-line switch, the logging of certain operations of
+the PerlIO subsystem will be redirected to the specified file rather
+than going to stderr, which is the default. The file is opened in append
+mode. Typical uses are in Unix:
- % env PERLIO_DEBUG=/dev/tty perl script ...
+ % env PERLIO_DEBUG=/tmp/perlio.log perl -Di script ...
and under Win32, the approximately equivalent:
> set PERLIO_DEBUG=CON
- perl script ...
+ perl -Di script ...
-This functionality is disabled for setuid scripts and for scripts run
-with B<-T>.
+This functionality is disabled for setuid scripts, for scripts run
+with B<-T>, and for scripts run on a Perl built without C<-DDEBUGGING>
+support.
=item PERLLIB
X<PERLLIB>