From a9af2eb770c79f5ce318b2290aaa80f17ba51c29 Mon Sep 17 00:00:00 2001
From: Julien BERNARD <julien.bernard@viagenie.ca>
Date: Wed, 23 Feb 2022 14:22:38 -0500
Subject: [PATCH] Update information for IDN usage with InternetDomainName

Update IDNA RFC references
---
 .../com/google/common/net/InternetDomainName.java  | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/guava/src/com/google/common/net/InternetDomainName.java b/guava/src/com/google/common/net/InternetDomainName.java
index d71a9d5c3c6c..b809112a0925 100644
--- 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:
    *