Generate Javadoc and JDiff for Guava HEAD-jre-SNAPSHOT

google · May 8, 2024 · f778a4d · f778a4d
1 parent 5190cb0
commit f778a4d
Show file tree

Hide file tree

Showing 50 changed files with 130 additions and 130 deletions.
diff --git a/releases/snapshot-android/api/diffs/snapshot-android.xml b/releases/snapshot-android/api/diffs/snapshot-android.xml
@@ -17630,13 +17630,13 @@
       abstract="false" native="false" synchronized="false"
       static="true" final="false" visibility="public"
       deprecated="not deprecated">
-      <param name="element" type="E"/>
+      <param name="e1" type="E"/>
       <doc>
       <![CDATA[Returns an immutable list containing a single element. This list behaves and performs
  comparably to {@link Collections#singletonList}, but will not accept a null element. It is
  preferable mainly for consistency and maintainability of your code.
 
- @throws NullPointerException if {@code element} is null]]>
+ @throws NullPointerException if the element is null]]>
       </doc>
     </method>
     <method name="of" return="com.google.common.collect.ImmutableList&lt;E&gt;"
@@ -19755,11 +19755,11 @@
       abstract="false" native="false" synchronized="false"
       static="true" final="false" visibility="public"
       deprecated="not deprecated">
-      <param name="element" type="E"/>
+      <param name="e1" type="E"/>
       <doc>
       <![CDATA[Returns an immutable multiset containing a single element.
 
- @throws NullPointerException if {@code element} is null
+ @throws NullPointerException if the element is null
  @since 6.0 (source-compatible since 2.0)]]>
       </doc>
     </method>
@@ -20735,9 +20735,9 @@
       abstract="false" native="false" synchronized="false"
       static="true" final="false" visibility="public"
       deprecated="not deprecated">
-      <param name="element" type="E"/>
+      <param name="e1" type="E"/>
       <doc>
-      <![CDATA[Returns an immutable set containing {@code element}. Preferred over {@link
+      <![CDATA[Returns an immutable set containing the given element. Preferred over {@link
  Collections#singleton} for code consistency, {@code null} rejection, and because the return
  type conveys the immutability guarantee.]]>
       </doc>
@@ -22649,7 +22649,7 @@
       abstract="false" native="false" synchronized="false"
       static="true" final="false" visibility="public"
       deprecated="not deprecated">
-      <param name="element" type="E extends java.lang.Comparable&lt;? super E&gt;"/>
+      <param name="e1" type="E extends java.lang.Comparable&lt;? super E&gt;"/>
       <doc>
       <![CDATA[Returns an immutable sorted multiset containing a single element.]]>
       </doc>
@@ -22989,7 +22989,7 @@
       static="true" final="false" visibility="public"
       deprecated="lEsS_tHaNb>Pass a parameter of type {@code Comparable} to use {@link
      ImmutableSortedMultiset#of(Comparable)}.lEsS_tHaN/b>">
-      <param name="element" type="E"/>
+      <param name="e1" type="E"/>
       <doc>
       <![CDATA[Not supported. <b>You are attempting to create a multiset that may contain a non-{@code
  Comparable} element.</b> Proper calls will resolve to the version in {@code
@@ -23300,7 +23300,7 @@
       abstract="false" native="false" synchronized="false"
       static="true" final="false" visibility="public"
       deprecated="not deprecated">
-      <param name="element" type="E extends java.lang.Comparable&lt;? super E&gt;"/>
+      <param name="e1" type="E extends java.lang.Comparable&lt;? super E&gt;"/>
       <doc>
       <![CDATA[Returns an immutable sorted set containing a single element.]]>
       </doc>
@@ -23810,7 +23810,7 @@
       static="true" final="false" visibility="public"
       deprecated="lEsS_tHaNb>Pass a parameter of type {@code Comparable} to use {@link
      ImmutableSortedSet#of(Comparable)}.lEsS_tHaN/b>">
-      <param name="element" type="E"/>
+      <param name="e1" type="E"/>
       <doc>
       <![CDATA[Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable}
  element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html
@@ -333,7 +333,7 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i18" class="altColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="ImmutableList.html" title="class in com.google.common.collect">ImmutableList</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable list containing a single element.</div>
 </td>
@@ -638,13 +638,13 @@ <h4>of</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>of</h4>
-<pre class="methodSignature">public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableList.html" title="class in com.google.common.collect">ImmutableList</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableList.html#line.100">of</a>&#8203;(E&nbsp;element)</pre>
+<pre class="methodSignature">public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableList.html" title="class in com.google.common.collect">ImmutableList</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableList.html#line.100">of</a>&#8203;(E&nbsp;e1)</pre>
 <div class="block">Returns an immutable list containing a single element. This list behaves and performs
  comparably to <code>Collections.singletonList(T)</code>, but will not accept a null element. It is
  preferable mainly for consistency and maintainability of your code.</div>
 <dl>
 <dt><span class="throwsLabel">Throws:</span></dt>
-<dd><code>java.lang.NullPointerException</code> - if <code>element</code> is null</dd>
+<dd><code>java.lang.NullPointerException</code> - if the element is null</dd>
 </dl>
 </li>
 </ul>

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultiset.html
@@ -325,7 +325,7 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i13" class="rowColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="ImmutableMultiset.html" title="class in com.google.common.collect">ImmutableMultiset</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable multiset containing a single element.</div>
 </td>
@@ -556,11 +556,11 @@ <h4>of</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>of</h4>
-<pre class="methodSignature">public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableMultiset.html" title="class in com.google.common.collect">ImmutableMultiset</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableMultiset.html#line.115">of</a>&#8203;(E&nbsp;element)</pre>
+<pre class="methodSignature">public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableMultiset.html" title="class in com.google.common.collect">ImmutableMultiset</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableMultiset.html#line.115">of</a>&#8203;(E&nbsp;e1)</pre>
 <div class="block">Returns an immutable multiset containing a single element.</div>
 <dl>
 <dt><span class="throwsLabel">Throws:</span></dt>
-<dd><code>java.lang.NullPointerException</code> - if <code>element</code> is null</dd>
+<dd><code>java.lang.NullPointerException</code> - if the element is null</dd>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>6.0 (source-compatible since 2.0)</dd>
 </dl>

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html
@@ -288,9 +288,9 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i11" class="rowColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="ImmutableSet.html" title="class in com.google.common.collect">ImmutableSet</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
-<div class="block">Returns an immutable set containing <code>element</code>.</div>
+<div class="block">Returns an immutable set containing the given element.</div>
 </td>
 </tr>
 <tr id="i12" class="altColor">
@@ -455,8 +455,8 @@ <h4>of</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>of</h4>
-<pre class="methodSignature">public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableSet.html" title="class in com.google.common.collect">ImmutableSet</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSet.html#line.88">of</a>&#8203;(E&nbsp;element)</pre>
-<div class="block">Returns an immutable set containing <code>element</code>. Preferred over <code>Collections.singleton(T)</code> for code consistency, <code>null</code> rejection, and because the return
+<pre class="methodSignature">public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableSet.html" title="class in com.google.common.collect">ImmutableSet</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSet.html#line.88">of</a>&#8203;(E&nbsp;e1)</pre>
+<div class="block">Returns an immutable set containing the given element. Preferred over <code>Collections.singleton(T)</code> for code consistency, <code>null</code> rejection, and because the return
  type conveys the immutability guarantee.</div>
 </li>
 </ul>

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedMultiset.html
@@ -341,7 +341,7 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i14" class="altColor">
 <td class="colFirst"><code>static &lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;<br><a href="ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable sorted multiset containing a single element.</div>
 </td>
@@ -628,7 +628,7 @@ <h4>of</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>of</h4>
-<pre class="methodSignature">public static&nbsp;&lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;&nbsp;<a href="ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedMultiset.html#line.143">of</a>&#8203;(E&nbsp;element)</pre>
+<pre class="methodSignature">public static&nbsp;&lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;&nbsp;<a href="ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedMultiset.html#line.143">of</a>&#8203;(E&nbsp;e1)</pre>
 <div class="block">Returns an immutable sorted multiset containing a single element.</div>
 </li>
 </ul>
@@ -1170,7 +1170,7 @@ <h4>builder</h4>
 <li class="blockList">
 <h4>of</h4>
 <pre class="methodSignature">@Deprecated
-public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedMultiset.html#line.818">of</a>&#8203;(E&nbsp;element)</pre>
+public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedMultiset.html#line.818">of</a>&#8203;(E&nbsp;e1)</pre>
 <div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
 <div class="deprecationComment"><b>Pass a parameter of type <code>Comparable</code> to use <a href="#of(E)"><code>of(Comparable)</code></a>.</b></div>
 </div>

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedSet.html
@@ -395,7 +395,7 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i25" class="rowColor">
 <td class="colFirst"><code>static &lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;<br><a href="ImmutableSortedSet.html" title="class in com.google.common.collect">ImmutableSortedSet</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable sorted set containing a single element.</div>
 </td>
@@ -636,7 +636,7 @@ <h4>of</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>of</h4>
-<pre class="methodSignature">public static&nbsp;&lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;&nbsp;<a href="ImmutableSortedSet.html" title="class in com.google.common.collect">ImmutableSortedSet</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedSet.html#line.106">of</a>&#8203;(E&nbsp;element)</pre>
+<pre class="methodSignature">public static&nbsp;&lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;&nbsp;<a href="ImmutableSortedSet.html" title="class in com.google.common.collect">ImmutableSortedSet</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedSet.html#line.106">of</a>&#8203;(E&nbsp;e1)</pre>
 <div class="block">Returns an immutable sorted set containing a single element.</div>
 </li>
 </ul>
@@ -1403,7 +1403,7 @@ <h4>builderWithExpectedSize</h4>
 <li class="blockList">
 <h4>of</h4>
 <pre class="methodSignature">@Deprecated
-public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableSortedSet.html" title="class in com.google.common.collect">ImmutableSortedSet</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedSet.html#line.846">of</a>&#8203;(E&nbsp;element)</pre>
+public static&nbsp;&lt;E&gt;&nbsp;<a href="ImmutableSortedSet.html" title="class in com.google.common.collect">ImmutableSortedSet</a>&lt;E&gt;&nbsp;<a href="../../../../src-html/com/google/common/collect/ImmutableSortedSet.html#line.846">of</a>&#8203;(E&nbsp;e1)</pre>
 <div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
 <div class="deprecationComment"><b>Pass a parameter of type <code>Comparable</code> to use <a href="#of(E)"><code>of(Comparable)</code></a>.</b></div>
 </div>

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableList.html b/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableList.html
@@ -255,7 +255,7 @@ <h3>Uses of <a href="../ImmutableList.html" title="class in com.google.common.co
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="../ImmutableList.html" title="class in com.google.common.collect">ImmutableList</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableList.</span><code><span class="memberNameLink"><a href="../ImmutableList.html#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableList.</span><code><span class="memberNameLink"><a href="../ImmutableList.html#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable list containing a single element.</div>
 </td>

diff --git a/...ases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableMultiset.html b/...ases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableMultiset.html
@@ -206,7 +206,7 @@ <h3>Uses of <a href="../ImmutableMultiset.html" title="class in com.google.commo
 </tr>
 <tr class="rowColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="../ImmutableMultiset.html" title="class in com.google.common.collect">ImmutableMultiset</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableMultiset.</span><code><span class="memberNameLink"><a href="../ImmutableMultiset.html#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableMultiset.</span><code><span class="memberNameLink"><a href="../ImmutableMultiset.html#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable multiset containing a single element.</div>
 </td>

diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableSet.html
@@ -318,9 +318,9 @@ <h3>Uses of <a href="../ImmutableSet.html" title="class in com.google.common.col
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="../ImmutableSet.html" title="class in com.google.common.collect">ImmutableSet</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableSet.</span><code><span class="memberNameLink"><a href="../ImmutableSet.html#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableSet.</span><code><span class="memberNameLink"><a href="../ImmutableSet.html#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
-<div class="block">Returns an immutable set containing <code>element</code>.</div>
+<div class="block">Returns an immutable set containing the given element.</div>
 </td>
 </tr>
 <tr class="rowColor">

diff --git a/...napshot-android/api/docs/com/google/common/collect/class-use/ImmutableSortedMultiset.html b/...napshot-android/api/docs/com/google/common/collect/class-use/ImmutableSortedMultiset.html
@@ -217,14 +217,14 @@ <h3>Uses of <a href="../ImmutableSortedMultiset.html" title="class in com.google
 </tr>
 <tr class="rowColor">
 <td class="colFirst"><code>static &lt;E extends java.lang.Comparable&lt;? super E&gt;&gt;<br><a href="../ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableSortedMultiset.</span><code><span class="memberNameLink"><a href="../ImmutableSortedMultiset.html#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableSortedMultiset.</span><code><span class="memberNameLink"><a href="../ImmutableSortedMultiset.html#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block">Returns an immutable sorted multiset containing a single element.</div>
 </td>
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="../ImmutableSortedMultiset.html" title="class in com.google.common.collect">ImmutableSortedMultiset</a>&lt;E&gt;</code></td>
-<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableSortedMultiset.</span><code><span class="memberNameLink"><a href="../ImmutableSortedMultiset.html#of(E)">of</a></span>&#8203;(E&nbsp;element)</code></th>
+<th class="colSecond" scope="row"><span class="typeNameLabel">ImmutableSortedMultiset.</span><code><span class="memberNameLink"><a href="../ImmutableSortedMultiset.html#of(E)">of</a></span>&#8203;(E&nbsp;e1)</code></th>
 <td class="colLast">
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>
 <div class="deprecationComment"><b>Pass a parameter of type <code>Comparable</code> to use <a href="../ImmutableSortedMultiset.html#of(E)"><code>of(Comparable)</code></a>.</b></div>