</refsect1>
-<refsect1 id='note'><title>NOTE</title>
+<refsect1 id='bugs'><title>NOTE</title>
<para>The -q, -l, and -m options of the 1.0 versions are gone. What they
used to do has been made unnecessary by smarter logic.</para>
</refsect1>
+<refsect1 id='note'><title>BUGS</title>
+<para>The code uses regular expressions rather than true HTML/XML parsing.
+Some perverse but legal constructions, like extraneous space within quoted
+numeric attributes, will be mangled.</para>
+</refsect1>
+
<refsect1 id='author'><title>AUTHOR</title>
<para>Originally created by Eric S. Raymond <esr@thyrsus.com>.
Additional code contributed by Erik Rossen, Michael C. Toren