X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlfilter.pod;h=51cd8ced75331761f668c145e6aa612a3c9a7646;hb=075502290ff69af888b5629ff1fecf91d588fbbd;hp=0103f8cfa3180da479ec0863bdd09a4aecb189b3;hpb=d1be9408a3c14848d30728674452e191ba5fffaa;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perlfilter.pod b/pod/perlfilter.pod
index 0103f8c..51cd8ce 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