From: Matt S Trout <mst@shadowcat.co.uk>
Date: Mon, 18 Mar 2013 15:42:57 +0000 (+0000)
Subject: add comment to tell people to stop being scared of the parser
X-Git-Tag: 0.009009~1^2~19
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FHTML-Zoom.git;a=commitdiff_plain;h=af6300beb9c3e10e23c540973dc8fba94c194c56;hp=b0ed28590e66eac5f5cb294a650c6d8faff00dd5

add comment to tell people to stop being scared of the parser
---

diff --git a/lib/HTML/Zoom/Parser/BuiltIn.pm b/lib/HTML/Zoom/Parser/BuiltIn.pm
index b55cc4d..13ae444 100644
--- a/lib/HTML/Zoom/Parser/BuiltIn.pm
+++ b/lib/HTML/Zoom/Parser/BuiltIn.pm
@@ -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 (