Add a note about non-reentrancy.

diff --git a/perl-sax/XML/TemplateSAX.pm b/perl-sax/XML/TemplateSAX.pm
index aba8c216af0a5e425ce86cc52612527166341c5d..e5e6e400fe629eca73edf539c65decdcd289c486 100644 (file)
--- a/perl-sax/XML/TemplateSAX.pm
+++ b/perl-sax/XML/TemplateSAX.pm
@@ -14,7 +14,10 @@
 # - You can no longer insert a DOM tree, naturally. Instead, you can set up
 #   an XML::TemplateSAX::Buffer, let it gobble up your data, and send it
 #   in the way you'd insert a DOM tree. process_file_to_buffer does this
-#   transparently for you, returning a buffer you can give in.
+#   transparently for you, returning a buffer you can give in. (In theory,
+#   one could avoid the buffering and just defer the parsing/filtering until
+#   it's needed, but Expat seems non-reentrant, which means starting a parser
+#   from within a begin_element callback blows up.)
 #
 
 use strict;