Skip to content

Commit

Permalink
Generate Javadoc and JDiff for Guava HEAD-jre-SNAPSHOT
Browse files Browse the repository at this point in the history
  • Loading branch information
copybara-service[bot] committed Dec 19, 2024
1 parent fe94556 commit d2ff389
Show file tree
Hide file tree
Showing 34 changed files with 1,813 additions and 1,841 deletions.
7 changes: 3 additions & 4 deletions releases/snapshot-android/api/diffs/snapshot-android.xml
Original file line number Diff line number Diff line change
Expand Up @@ -23280,7 +23280,7 @@
reverse of their natural ordering.

<p>Note: the type parameter {@code E} extends {@code Comparable<?>} rather than {@code
Comparable<? super E>} as a workaround for javac <a
Comparable<? super E>} in order to accommodate users of obsolete javac versions affected by <a
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468354">bug 6468354</a>.]]>
</doc>
</method>
Expand All @@ -23295,7 +23295,7 @@
that implement {@link Comparable}.

<p>Note: the type parameter {@code E} extends {@code Comparable<?>} rather than {@code
Comparable<? super E>} as a workaround for javac <a
Comparable<? super E>} in order to accommodate users of obsolete javac versions affected by <a
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468354">bug 6468354</a>.]]>
</doc>
</method>
Expand Down Expand Up @@ -31710,8 +31710,7 @@
<p>In addition to these required methods, implementations of {@code Multiset} are expected to
provide two {@code static} creation methods: {@code create()}, returning an empty multiset, and
{@code create(Iterable<? extends E>)}, returning a multiset containing the given initial
elements. This is simply a refinement of {@code Collection}'s constructor recommendations,
reflecting the new developments of Java 5.
elements. This is simply a refinement of {@code Collection}'s constructor recommendations.

<p>As with other collection types, the modification operations are optional, and should throw
{@link UnsupportedOperationException} when they are not implemented. Most implementations should
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1073,7 +1073,7 @@ <h4>reverseOrder</h4>
reverse of their natural ordering.

<p>Note: the type parameter <code>E</code> extends <code>Comparable&lt;?&gt;</code> rather than <code>
Comparable&lt;? super E&gt;</code> as a workaround for javac <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468354">bug 6468354</a>.</div>
Comparable&lt;? super E&gt;</code> in order to accommodate users of obsolete javac versions affected by <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468354">bug 6468354</a>.</div>
</li>
</ul>
<a id="naturalOrder()">
Expand All @@ -1089,7 +1089,7 @@ <h4>naturalOrder</h4>
that implement <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang" class="externalLink"><code>Comparable</code></a>.

<p>Note: the type parameter <code>E</code> extends <code>Comparable&lt;?&gt;</code> rather than <code>
Comparable&lt;? super E&gt;</code> as a workaround for javac <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468354">bug 6468354</a>.</div>
Comparable&lt;? super E&gt;</code> in order to accommodate users of obsolete javac versions affected by <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468354">bug 6468354</a>.</div>
</li>
</ul>
<a id="toImmutableMultiset()">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -128,7 +128,7 @@ <h2 title="Interface Multiset.Entry" class="title">Interface Multiset.Entry&lt;E
<dd><a href="Multiset.html" title="interface in com.google.common.collect">Multiset</a>&lt;<a href="Multiset.html" title="type parameter in Multiset">E</a> extends <a href="https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/Nullable.html?is-external=true" title="class or interface in org.checkerframework.checker.nullness.qual" class="externalLink">@Nullable</a> <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a>&gt;</dd>
</dl>
<hr>
<pre>public static interface <a href="../../../../src-html/com/google/common/collect/Multiset.html#line.276">Multiset.Entry</a>&lt;E extends <a href="https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/Nullable.html?is-external=true" title="class or interface in org.checkerframework.checker.nullness.qual" class="externalLink">@Nullable</a> <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a>&gt;</pre>
<pre>public static interface <a href="../../../../src-html/com/google/common/collect/Multiset.html#line.275">Multiset.Entry</a>&lt;E extends <a href="https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/Nullable.html?is-external=true" title="class or interface in org.checkerframework.checker.nullness.qual" class="externalLink">@Nullable</a> <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a>&gt;</pre>
<div class="block">An unmodifiable element-count pair for a multiset. The <a href="Multiset.html#entrySet()"><code>Multiset.entrySet()</code></a> method returns
a view of the multiset whose elements are of this class. A multiset implementation may return
Entry instances that are either live "read-through" views to the Multiset, or immutable
Expand Down Expand Up @@ -209,7 +209,7 @@ <h3>Method Detail</h3>
<ul class="blockList">
<li class="blockList">
<h4>getElement</h4>
<pre class="methodSignature"><a href="Multiset.Entry.html" title="type parameter in Multiset.Entry">E</a>&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.284">getElement</a>()</pre>
<pre class="methodSignature"><a href="Multiset.Entry.html" title="type parameter in Multiset.Entry">E</a>&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.283">getElement</a>()</pre>
<div class="block">Returns the multiset element corresponding to this entry. Multiple calls to this method
always return the same instance.</div>
<dl>
Expand All @@ -224,7 +224,7 @@ <h4>getElement</h4>
<ul class="blockList">
<li class="blockList">
<h4>getCount</h4>
<pre class="methodSignature">int&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.296">getCount</a>()</pre>
<pre class="methodSignature">int&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.295">getCount</a>()</pre>
<div class="block">Returns the count of the associated element in the underlying multiset. This count may either
be an unchanging snapshot of the count at the time the entry was retrieved, or a live view of
the current count of the element in the multiset, depending on the implementation. Note that
Expand All @@ -242,7 +242,7 @@ <h4>getCount</h4>
<ul class="blockList">
<li class="blockList">
<h4>equals</h4>
<pre class="methodSignature">boolean&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.310">equals</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 class="methodSignature">boolean&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.309">equals</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>
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a>&nbsp;o)</pre>
<div class="block">

Expand All @@ -266,7 +266,7 @@ <h4>equals</h4>
<ul class="blockList">
<li class="blockList">
<h4>hashCode</h4>
<pre class="methodSignature">int&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.324">hashCode</a>()</pre>
<pre class="methodSignature">int&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.323">hashCode</a>()</pre>
<div class="block">

<p>The hash code of a multiset entry for element <code>element</code> and count <code>count</code> is
Expand All @@ -287,7 +287,7 @@ <h4>hashCode</h4>
<ul class="blockListLast">
<li class="blockList">
<h4>toString</h4>
<pre class="methodSignature"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang" class="externalLink">String</a>&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.333">toString</a>()</pre>
<pre class="methodSignature"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang" class="externalLink">String</a>&nbsp;<a href="../../../../src-html/com/google/common/collect/Multiset.Entry.html#line.332">toString</a>()</pre>
<div class="block">Returns the canonical string representation of this entry, defined as follows. If the count
for this entry is one, this is simply the string representation of the corresponding element.
Otherwise, it is the string representation of the element, followed by the three characters
Expand Down
Loading

0 comments on commit d2ff389

Please sign in to comment.