Generate Javadoc and JDiff for Guava HEAD-jre-SNAPSHOT

Author: copybara-service[bot]

releases/snapshot-android/api/diffs/snapshot-android.xml

@@ -54205,7 +54205,9 @@
  @param ipString {@code String} containing an IPv4 or IPv6 string literal, e.g. {@code
      "192.168.0.1"} or {@code "2001:db8::1"} or with a scope ID, e.g. {@code "2001:db8::1%eth0"}
  @return {@link InetAddress} representing the argument
- @throws IllegalArgumentException if the argument is not a valid IP string literal]]>
+ @throws IllegalArgumentException if the argument is not a valid IP string literal or if the
+     address has a scope ID that fails validation against the interfaces on the machine (as
+     required by Java's {@link InetAddress})]]>
       </doc>
     </method>
     <method name="isInetAddress" return="boolean"
@@ -54222,6 +54224,10 @@
  want to accept ASCII digits only, you can use something like {@code
  CharMatcher.ascii().matchesAllOf(ipString)}.
 
+ <p>Note that if this method returns {@code true}, a call to {@link #forString(String)} can
+ still throw if the address has a scope ID that fails validation against the interfaces on the
+ machine.
+
  @param ipString {@code String} to evaluated as an IP string literal
  @return {@code true} if the argument is a valid IP string literal]]>
       </doc>
@@ -54297,8 +54303,9 @@
  @param hostAddr an RFC 3986 section 3.2.2 encoded IPv4 or IPv6 address
  @return an InetAddress representing the address in {@code hostAddr}
  @throws IllegalArgumentException if {@code hostAddr} is not a valid IPv4 address, or IPv6
-     address surrounded by square brackets, or if the address has a scope id that fails
-     validation against interfaces on the machine]]>
+     address surrounded by square brackets, or if the address has a scope ID that fails
+     validation against the interfaces on the machine (as required by Java's {@link
+     InetAddress})]]>
       </doc>
     </method>
     <method name="isUriInetAddress" return="boolean"
@@ -54316,7 +54323,8 @@
  CharMatcher.ascii().matchesAllOf(ipString)}.
 
  <p>Note that if this method returns {@code true}, a call to {@link #forUriString(String)} can
- throw if the address has a scope id fails validation against interfaces on the machine.
+ still throw if the address has a scope ID that fails validation against the interfaces on the
+ machine.
 
  @param ipString {@code String} to evaluated as an IP URI host string literal
  @return {@code true} if the argument is a valid IP URI host]]>

releases/snapshot-android/api/docs/com/google/common/net/InetAddresses.TeredoInfo.html

@@ -136,7 +136,7 @@ <h2 title="Class InetAddresses.TeredoInfo" class="title">Class InetAddresses.Ter
 <dd><a href="InetAddresses.html" title="class in com.google.common.net">InetAddresses</a></dd>
 </dl>
 <hr>
-<pre>public static final class <a href="../../../../src-html/com/google/common/net/InetAddresses.html#line.751">InetAddresses.TeredoInfo</a>
+<pre>public static final class <a href="../../../../src-html/com/google/common/net/InetAddresses.html#line.759">InetAddresses.TeredoInfo</a>
 extends java.lang.Object</pre>
 <div class="block">A simple immutable data class to encapsulate the information to be found in a Teredo address.
 
@@ -246,7 +246,7 @@ <h3>Constructor Detail</h3>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>TeredoInfo</h4>
-<pre>public&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.767">TeredoInfo</a>&#8203;(<a href="https://checkerframework.org/api/javax/annotation/CheckForNull.html?is-external=true" title="class or interface in javax.annotation" class="externalLink">@CheckForNull</a>
+<pre>public&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.775">TeredoInfo</a>&#8203;(<a href="https://checkerframework.org/api/javax/annotation/CheckForNull.html?is-external=true" title="class or interface in javax.annotation" class="externalLink">@CheckForNull</a>
                   java.net.Inet4Address&nbsp;server,
                   <a href="https://checkerframework.org/api/javax/annotation/CheckForNull.html?is-external=true" title="class or interface in javax.annotation" class="externalLink">@CheckForNull</a>
                   java.net.Inet4Address&nbsp;client,
@@ -279,7 +279,7 @@ <h3>Method Detail</h3>
 <ul class="blockList">
 <li class="blockList">
 <h4>getServer</h4>
-<pre class="methodSignature">public&nbsp;java.net.Inet4Address&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.782">getServer</a>()</pre>
+<pre class="methodSignature">public&nbsp;java.net.Inet4Address&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.790">getServer</a>()</pre>
 </li>
 </ul>
 <a id="getClient()">
@@ -288,7 +288,7 @@ <h4>getServer</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>getClient</h4>
-<pre class="methodSignature">public&nbsp;java.net.Inet4Address&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.786">getClient</a>()</pre>
+<pre class="methodSignature">public&nbsp;java.net.Inet4Address&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.794">getClient</a>()</pre>
 </li>
 </ul>
 <a id="getPort()">
@@ -297,7 +297,7 @@ <h4>getClient</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>getPort</h4>
-<pre class="methodSignature">public&nbsp;int&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.790">getPort</a>()</pre>
+<pre class="methodSignature">public&nbsp;int&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.798">getPort</a>()</pre>
 </li>
 </ul>
 <a id="getFlags()">
@@ -306,7 +306,7 @@ <h4>getPort</h4>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>getFlags</h4>
-<pre class="methodSignature">public&nbsp;int&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.794">getFlags</a>()</pre>
+<pre class="methodSignature">public&nbsp;int&nbsp;<a href="../../../../src-html/com/google/common/net/InetAddresses.TeredoInfo.html#line.802">getFlags</a>()</pre>
 </li>
 </ul>
 </li>