DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUGĀ·
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=37385>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED ANDĀ·
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=37385

           Summary: EscapeUtil.escapeHtml() should clarify that it does not
                    escape ' chars to &apos;
           Product: Commons
           Version: 2.1 Final
          Platform: All
               URL: http://jakarta.apache.org/commons/lang/apidocs/org/apach
                    e/commons/lang/StringEscapeUtils.html#escapeHtml(java.la
                    ng.String)
        OS/Version: All
            Status: NEW
          Severity: minor
          Priority: P4
         Component: Lang
        AssignedTo: commons-dev@jakarta.apache.org
        ReportedBy: [EMAIL PROTECTED]


The official HTML character entity spec does not include the popular "&apos;"
entity name for the single quote character '. the StringUtils class correctly
follows this behavior, leaving single quotes alone. However, many developers
incorrectly assume that ' will get escaped into &apos; (I was one!) and we can
help them by clarifying this in the Javadoc.

The following could be appended to the method Javadoc:

Note: Not all common HTML entity names are formally included in the standard
specification (http://www.w3.org/TR/REC-html40/sgml/entities.html, as listed
below). This method follows the standard, and thus does not escape the
single-quote ' character into &apos.

-- 
Configure bugmail: http://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to