From: Georg Brandl Date: Sat, 1 Apr 2006 08:39:50 +0000 (+0000) Subject: clarify new docs on attr value entity expansion X-Git-Tag: v2.5a1~92 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9cdf56318d3bffbf15643de55a09ef3952bd6914;p=python clarify new docs on attr value entity expansion --- diff --git a/Doc/lib/libsgmllib.tex b/Doc/lib/libsgmllib.tex index 592c191631..cae6821048 100644 --- a/Doc/lib/libsgmllib.tex +++ b/Doc/lib/libsgmllib.tex @@ -95,9 +95,16 @@ lower case, and the \var{method} argument is the bound method which should be used to support semantic interpretation of the start tag. The \var{attributes} argument is a list of \code{(\var{name}, \var{value})} pairs containing the attributes found inside the tag's -\code{<>} brackets. The \var{name} has been translated to lower case. +\code{<>} brackets. + +The \var{name} has been translated to lower case. Double quotes and backslashes in the \var{value} have been interpreted, -as well as known entity and character references. +as well as known character references and known entity references +terminated by a semicolon (normally, entity references can be terminated +by any non-alphanumerical character, but this would break the very +common case of \code{} when \code{eggs} +is a valid entity name). + For instance, for the tag \code{}, this method would be called as \samp{unknown_starttag('a', [('href', 'http://www.cwi.nl/')])}. The base implementation simply calls