[ python-Bugs-793702 ] Section 13.1 HTMLParser documentation error

[SourceForge.net]

Bugs item #793702, was opened at 2003-08-23 06:01
Message generated for change (Comment added) made by fdrake
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=793702&group_id=5470

Category: Documentation
Group: Python 2.3
>Status: Closed
>Resolution: Fixed
Priority: 5
Submitted By: Martin Baker (kemokid)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: Section 13.1 HTMLParser documentation error

Initial Comment:
The description for handle_comment() says:

     The comment argument is a string containing the
text between the "<!-" and "->" delimiters, but not the
delimiters themselves. For example, the comment
"<!-text->" will cause this method to be called with
the argument &#039;text&#039;.

This is incorrect - the comment delimiters are "<!--"
and "-->" (two hyphens, not just one). Purusing the
code, it appears that the module itself behaves
correctly, so this is only a very minor documentation
bug, but to a HTML newbie, it could be an incredibly
frustrating one.

This was seen on 2003/8/23 at
http://www.python.org/doc/current/lib/module-HTMLParser.html

And a big thank you to all Pythonic volunteers!

----------------------------------------------------------------------

>Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2004-03-31 23:45

Message:
Logged In: YES 
user_id=3066

Hmm, I must not have noticed this report when I fixed the
bug.  This was fixed in Doc/perl/python.perl 1.144.

I've backported the fix to Python 2.3.4 as
Doc/perl/python.perl 1.137.8.2.

This problem was only an issue for the HTML and iSilo
conversions (the later only because it relied on the HTML
conversion).

----------------------------------------------------------------------

Comment By: Raymond Hettinger (rhettinger)
Date: 2003-09-17 02:04

Message:
Logged In: YES 
user_id=80475

My fix didn't take.
Re-opening and assigning to Fred so the job gets done right.

----------------------------------------------------------------------

Comment By: Raymond Hettinger (rhettinger)
Date: 2003-08-24 23:32

Message:
Logged In: YES 
user_id=80475

Thanks for the bug report.
It looks like TeX was considering -- as a special character 
and only printing it once.  Escaping the hyphen ought to fix 
it.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=793702&group_id=5470