Skip to content

Commit

Permalink
Avoid backticks in Javadoc.
Browse files Browse the repository at this point in the history
RELNOTES=n/a
PiperOrigin-RevId: 684455708
  • Loading branch information
cpovirk authored and Google Java Core Libraries committed Oct 10, 2024
1 parent f5ec2ab commit d40589d
Show file tree
Hide file tree
Showing 12 changed files with 82 additions and 82 deletions.
4 changes: 2 additions & 2 deletions android/guava/src/com/google/common/base/MoreObjects.java
Original file line number Diff line number Diff line change
Expand Up @@ -174,8 +174,8 @@ public ToStringHelper omitNullValues() {
* empty values. The order of calling this method, relative to the {@code add()}/{@code
* addValue()} methods, is not significant.
*
* <p><b>Note:</b> in general, code should assume that the string form returned by
* `ToStringHelper` for a given object may change. In particular, the list of types which are
* <p><b>Note:</b> in general, code should assume that the string form returned by {@code
* ToStringHelper} for a given object may change. In particular, the list of types which are
* checked for emptiness is subject to change. We currently check {@code CharSequence}s, {@code
* Collection}s, {@code Map}s, optionals (including Guava's), and arrays.
*
Expand Down
16 changes: 8 additions & 8 deletions android/guava/src/com/google/common/graph/Graph.java
Original file line number Diff line number Diff line change
Expand Up @@ -166,8 +166,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -189,8 +189,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -215,8 +215,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -237,8 +237,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand Down
38 changes: 19 additions & 19 deletions android/guava/src/com/google/common/graph/Network.java
Original file line number Diff line number Diff line change
Expand Up @@ -170,8 +170,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -187,9 +187,9 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
*
* <p>In an undirected network, this is equivalent to {@link #adjacentNodes(Object)}.
*
* <p>If {@code node} is removed from the network after this method is called, the `Set` returned
* by this method will be invalidated, and will throw `IllegalStateException` if it is accessed in
* any way.
* <p>If {@code node} is removed from the network after this method is called, the {@code Set}
* returned by this method will be invalidated, and will throw {@code IllegalStateException} if it
* is accessed in any way.
*
* @throws IllegalArgumentException if {@code node} is not an element of this network
*/
Expand All @@ -210,8 +210,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -233,8 +233,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -258,8 +258,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -282,8 +282,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand Down Expand Up @@ -344,8 +344,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code edge} is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -372,8 +372,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code nodeU} or {@code nodeV} are re-added to the network after having been removed,
* {@code view}'s behavior is undefined
Expand Down Expand Up @@ -401,8 +401,8 @@ public interface Network<N, E> extends SuccessorsFunction<N>, PredecessorsFuncti
* exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if either endpoint is re-added to the network after having been removed, {@code view}'s
* behavior is undefined
Expand Down
4 changes: 2 additions & 2 deletions android/guava/src/com/google/common/graph/Traverser.java
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,8 @@ Traversal<N> newTraversal() {
* structure being traversed is, in addition to being a tree/forest, also defined <a
* href="https://github.com/google/guava/wiki/GraphsExplained#non-recursiveness">recursively</a>.
* This is because the {@code forTree()}-based implementations don't keep track of visited nodes,
* and therefore don't need to call `equals()` or `hashCode()` on the node objects; this saves
* both time and space versus traversing the same graph using {@code forGraph()}.
* and therefore don't need to call {@code equals()} or {@code hashCode()} on the node objects;
* this saves both time and space versus traversing the same graph using {@code forGraph()}.
*
* <p>Providing a graph to be traversed for which there is more than one path from the start
* node(s) to any node may lead to:
Expand Down
18 changes: 9 additions & 9 deletions android/guava/src/com/google/common/graph/ValueGraph.java
Original file line number Diff line number Diff line change
Expand Up @@ -175,8 +175,8 @@ public interface ValueGraph<N, V> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -193,9 +193,9 @@ public interface ValueGraph<N, V> extends BaseGraph<N> {
*
* <p>In an undirected graph, this is equivalent to {@link #adjacentNodes(Object)}.
*
* <p>If {@code node} is removed from the graph after this method is called, the `Set` returned by
* this method will be invalidated, and will throw `IllegalStateException` if it is accessed in
* any way.
* <p>If {@code node} is removed from the graph after this method is called, the {@code Set}
* returned by this method will be invalidated, and will throw {@code IllegalStateException} if it
* is accessed in any way.
*
* @throws IllegalArgumentException if {@code node} is not an element of this graph
*/
Expand All @@ -216,8 +216,8 @@ public interface ValueGraph<N, V> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -238,8 +238,8 @@ public interface ValueGraph<N, V> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -339,7 +339,7 @@ public static Executor directExecutor() {
*
* <p>{@linkplain Executor#execute executed} tasks have a happens-before order as defined in the
* Java Language Specification. Tasks execute with the same happens-before order that the function
* calls to {@link Executor#execute `execute()`} that submitted those tasks had.
* calls to {@link Executor#execute execute()} that submitted those tasks had.
*
* <p>The executor uses {@code delegate} in order to {@link Executor#execute execute} each task in
* turn, and does not create any threads of its own.
Expand Down
4 changes: 2 additions & 2 deletions guava/src/com/google/common/base/MoreObjects.java
Original file line number Diff line number Diff line change
Expand Up @@ -177,8 +177,8 @@ public ToStringHelper omitNullValues() {
* empty values. The order of calling this method, relative to the {@code add()}/{@code
* addValue()} methods, is not significant.
*
* <p><b>Note:</b> in general, code should assume that the string form returned by
* `ToStringHelper` for a given object may change. In particular, the list of types which are
* <p><b>Note:</b> in general, code should assume that the string form returned by {@code
* ToStringHelper} for a given object may change. In particular, the list of types which are
* checked for emptiness is subject to change. We currently check {@code CharSequence}s, {@code
* Collection}s, {@code Map}s, optionals (including Guava's), and arrays.
*
Expand Down
16 changes: 8 additions & 8 deletions guava/src/com/google/common/graph/Graph.java
Original file line number Diff line number Diff line change
Expand Up @@ -166,8 +166,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -189,8 +189,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -215,8 +215,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand All @@ -237,8 +237,8 @@ public interface Graph<N> extends BaseGraph<N> {
* IllegalStateException} if it is accessed in any way, with the following exceptions:
*
* <ul>
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other `equals()` expression
* involving {@code view} will throw)
* <li>{@code view.equals(view)} evaluates to {@code true} (but any other {@code equals()}
* expression involving {@code view} will throw)
* <li>{@code hashCode()} does not throw
* <li>if {@code node} is re-added to the graph after having been removed, {@code view}'s
* behavior is undefined
Expand Down
Loading

0 comments on commit d40589d

Please sign in to comment.