add comment to tell people to stop being scared of the parser
Matt S Trout [Mon, 18 Mar 2013 15:42:57 +0000 (15:42 +0000)]
lib/HTML/Zoom/Parser/BuiltIn.pm

index b55cc4d..13ae444 100644 (file)
@@ -16,6 +16,15 @@ sub html_to_stream {
               ->stream_from_array(@{$self->html_to_events($text)});
 }
 
+# DO NOT BE AFRAID.
+#
+# Well, ok. Be afraid. A little. But this is lexing HTML with a regexp,
+# not really parsing (since the structure nesting isn't handled here) so
+# it's relatively not dangerous.
+#
+# Certainly it's not really any more or any less heinous than anything else
+# I could do in a handful of lines of pure perl.
+
 sub _hacky_tag_parser {
   my ($text, $handler) = @_;
   while (