[Andrew Kuchling]
>
> Most Web browsers are very forgiving in their HTML parsing, so they
> often will infer the trailing semicolon if it isn't present.  Do a
> search on Google Groups for "HTML §ion" to find some of the
> endless threads in comp.infosystems.www.authoring.html about this.

No thanks. You don't have to convince me that browsers suck. I just want my
own HTML to be good.

> >In addition, I find the entire Note
> >incomprehensible. Is it just me? :-(
>
> It *is* confusing, because there are two levels of quoting going on
> here: URL and HTML.  For example, let's say you have a URL with
> 'action' and 'section' parameters, and you want the section to be the
> string 'R&D'.  You'd have to write 'action=search§ion=%s' %
> html.url_quote('R&D').  This results in the string
> 'action=search§ion=R%26D'.  But if you're putting the URL into an
> HTML page, it needs to be quoted for HTML properly with html_quote(),
> and you get the final HTML text 'action=search&keyword=R%26D'.

Now *that* example I can follow just fine. It isn't the concepts that are a
problem, just the wording of the current example in the docstring. I'd
suggest replacing it with the one you just gave here.

---
Patrick K. O'Brien
Orbtech