Update information for IDN usage with InternetDomainName

Update IDNA RFC references
google · Feb 23, 2022 · a9af2eb · a9af2eb
1 parent a0e2577
commit a9af2eb
Showing 1 changed file with 8 additions and 6 deletions.
diff --git a/guava/src/com/google/common/net/InternetDomainName.java b/guava/src/com/google/common/net/InternetDomainName.java
@@ -64,9 +64,11 @@
  * be reflected in the result of {@link #equals(Object)}.
  *
  * <p><a href="http://en.wikipedia.org/wiki/Internationalized_domain_name">Internationalized domain
- * names</a> such as {@code 网络.cn} are supported, as are the equivalent <a
+ * names (IDN)</a> such as {@code 网络.cn} are supported, as are the equivalent <a
  * href="http://en.wikipedia.org/wiki/Internationalized_domain_name">IDNA Punycode-encoded</a>
- * versions.
+ * versions. However, IDN are not validated against <a href="http://www.ietf.org/rfc/rfc5890.txt">
+ * RFC 5890</a> ("Internationalized Domain Names for Applications"), therefore using another
+ * library for IDN validation may be required.
  *
  * @author Catherine Berry
  * @since 5.0
@@ -189,8 +191,8 @@ private int findSuffixOfType(Optional<PublicSuffixType> desiredType) {
 
   /**
    * Returns an instance of {@link InternetDomainName} after lenient validation. Specifically,
-   * validation against <a href="http://www.ietf.org/rfc/rfc3490.txt">RFC 3490</a>
-   * ("Internationalizing Domain Names in Applications") is skipped, while validation against <a
+   * validation against <a href="http://www.ietf.org/rfc/rfc5890.txt">RFC 5890</a>
+   * ("Internationalized Domain Names for Applications") is skipped, while validation against <a
    * href="http://www.ietf.org/rfc/rfc1035.txt">RFC 1035</a> is relaxed in the following ways:
    *
    * <ul>
@@ -561,8 +563,8 @@ public InternetDomainName child(String leftParts) {
 
   /**
    * Indicates whether the argument is a syntactically valid domain name using lenient validation.
-   * Specifically, validation against <a href="http://www.ietf.org/rfc/rfc3490.txt">RFC 3490</a>
-   * ("Internationalizing Domain Names in Applications") is skipped.
+   * Specifically, validation against <a href="http://www.ietf.org/rfc/rfc5890.txt">RFC 5890</a>
+   * ("Internationalized Domain Names for Applications") is skipped.
    *
    * <p>The following two code snippets are equivalent:
    *