summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorCasey West <casey@geeknest.com>2003-04-28 07:07:36 -0400
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2003-05-05 20:31:22 +0000
commit6c3397db56d5151f21e501fb6fe11dd893f31ba7 (patch)
tree20ea819bb8c1bf3bc69a9e30238b7c72049fad8d /pod
parent4b3c1a47dc0fd4f1dba8913d1d8984fe79997756 (diff)
downloadperl-6c3397db56d5151f21e501fb6fe11dd893f31ba7.tar.gz
[perl #8063] perlfilter doesn't mention potential DATA clobber
Message-ID: <20030428150736.GD62281@geeknest.com> p4raw-id: //depot/perl@19432
Diffstat (limited to 'pod')
-rw-r--r--pod/perlfilter.pod14
1 files changed, 14 insertions, 0 deletions
diff --git a/pod/perlfilter.pod b/pod/perlfilter.pod
index 0103f8cfa3..51cd8ced75 100644
--- a/pod/perlfilter.pod
+++ b/pod/perlfilter.pod
@@ -551,6 +551,20 @@ useful features from the C preprocessor and any other macro processors
you know. The tricky bit will be choosing how much knowledge of Perl's
syntax you want your filter to have.
+=head1 THINGS TO LOOK OUT FOR
+
+=over 5
+
+=item Some Filters Clobber the C<DATA> Handle
+
+Some source filters use the C<DATA> handle to read the calling program.
+When using these source filters you cannot rely on this handle, nor expect
+any particular kind of behavior when operating on it. Filters based on
+Filter::Util::Call (and therefore Filter::Simple) do not alter the C<DATA>
+filehandle.
+
+=back
+
=head1 REQUIREMENTS
The Source Filters distribution is available on CPAN, in