Added note in javadoc of issue reported in LANG-66

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@418831 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Henri Yandell 2006-07-03 19:11:02 +00:00
parent 594ec5482d
commit 7f8f3da321
1 changed files with 12 additions and 0 deletions

View File

@ -566,6 +566,9 @@ public static void unescapeHtml(Writer writer, String string) throws IOException
* <p>Supports only the five basic XML entities (gt, lt, quot, amp, apos).
* Does not support DTDs or external entities.</p>
*
* <p>Note that unicode characters greater than 0x7f are currently escaped to
* their numerical \u equivalent. This may change in future releases. </p>
*
* @param writer the writer receiving the unescaped string, not null
* @param str the <code>String</code> to escape, may be null
* @return a new escaped <code>String</code>, <code>null</code> if null string input
@ -592,6 +595,9 @@ public static void escapeXml(Writer writer, String str) throws IOException {
* <p>Supports only the five basic XML entities (gt, lt, quot, amp, apos).
* Does not support DTDs or external entities.</p>
*
* <p>Note that unicode characters greater than 0x7f are currently escaped to
* their numerical \u equivalent. This may change in future releases. </p>
*
* @param str the <code>String</code> to escape, may be null
* @return a new escaped <code>String</code>, <code>null</code> if null string input
* @see #unescapeXml(java.lang.String)
@ -612,6 +618,9 @@ public static String escapeXml(String str) {
* <p>Supports only the five basic XML entities (gt, lt, quot, amp, apos).
* Does not support DTDs or external entities.</p>
*
* <p>Note that numerical \u unicode codes are unescaped to their respective
* unicode characters. This may change in future releases. </p>
*
* @param writer the writer receiving the unescaped string, not null
* @param str the <code>String</code> to unescape, may be null
* @return a new unescaped <code>String</code>, <code>null</code> if null string input
@ -636,6 +645,9 @@ public static void unescapeXml(Writer writer, String str) throws IOException {
* <p>Supports only the five basic XML entities (gt, lt, quot, amp, apos).
* Does not support DTDs or external entities.</p>
*
* <p>Note that numerical \u unicode codes are unescaped to their respective
* unicode characters. This may change in future releases. </p>
*
* @param str the <code>String</code> to unescape, may be null
* @return a new unescaped <code>String</code>, <code>null</code> if null string input
* @see #escapeXml(String)