Convert server javadoc to html5 (#30279)

This commit converts the remaining javadocs in :server using html4 to html5.
This was mostly converting `tt` to `{@code}`.

Author: rjernst

buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy

@@ -549,22 +549,6 @@ class BuildPlugin implements Plugin<Project> {
             javadoc.classpath = javadoc.getClasspath().filter { f ->
                 return classes.contains(f) == false
             }
-            /*
-             * Force html5 on projects that support it to silence the warning
-             * that `javadoc` will change its defaults in the future.
-             *
-             * But not all of our javadoc is actually valid html5. So we
-             * have to become valid incrementally. We only set html5 on the
-             * projects we have converted so that we still get the annoying
-             * warning on the unconverted ones. That will give us an
-             * incentive to convert them....
-             */
-            List html4Projects = [
-                ':server',
-            ]
-            if (false == html4Projects.contains(project.path)) {
-                javadoc.options.addBooleanOption('html5', true)
-            }
         }
         configureJavadocJar(project)
     }

buildSrc/src/main/groovy/org/elasticsearch/gradle/test/ClusterConfiguration.groovy

@@ -64,7 +64,7 @@ class ClusterConfiguration {
     boolean debug = false
 
     /**
-     * Configuration of the setting <tt>discovery.zen.minimum_master_nodes</tt> on the nodes.
+     * Configuration of the setting {@code discovery.zen.minimum_master_nodes} on the nodes.
      * In case of more than one node, this defaults to the number of nodes
      */
     @Input

server/src/main/java/org/apache/lucene/queries/ExtendedCommonTermsQuery.java

@@ -28,7 +28,7 @@
 
 /**
  * Extended version of {@link CommonTermsQuery} that allows to pass in a
- * <tt>minimumNumberShouldMatch</tt> specification that uses the actual num of high frequent terms
+ * {@code minimumNumberShouldMatch} specification that uses the actual num of high frequent terms
  * to calculate the minimum matching terms.
  */
 public class ExtendedCommonTermsQuery extends CommonTermsQuery {

server/src/main/java/org/elasticsearch/ElasticsearchException.java

@@ -668,7 +668,7 @@ protected String getExceptionName() {
     }
 
     /**
-     * Returns a underscore case name for the given exception. This method strips <tt>Elasticsearch</tt> prefixes from exception names.
+     * Returns a underscore case name for the given exception. This method strips {@code Elasticsearch} prefixes from exception names.
      */
     public static String getExceptionName(Throwable ex) {
         String simpleName = ex.getClass().getSimpleName();

server/src/main/java/org/elasticsearch/action/ShardOperationFailedException.java

@@ -31,12 +31,12 @@
 public interface ShardOperationFailedException extends Streamable, ToXContent {
 
     /**
-     * The index the operation failed on. Might return <tt>null</tt> if it can't be derived.
+     * The index the operation failed on. Might return {@code null} if it can't be derived.
      */
     String index();
 
     /**
-     * The index the operation failed on. Might return <tt>-1</tt> if it can't be derived.
+     * The index the operation failed on. Might return {@code -1} if it can't be derived.
      */
     int shardId();
 

server/src/main/java/org/elasticsearch/action/ThreadingModel.java

@@ -37,7 +37,7 @@ public byte id() {
     }
 
     /**
-     * <tt>true</tt> if the actual operation the action represents will be executed
+     * {@code true} if the actual operation the action represents will be executed
      * on a different thread than the calling thread (assuming it will be executed
      * on the same node).
      */
@@ -46,7 +46,7 @@ public boolean threadedOperation() {
     }
 
     /**
-     * <tt>true</tt> if the invocation of the action result listener will be executed
+     * {@code true} if the invocation of the action result listener will be executed
      * on a different thread (than the calling thread or an "expensive" thread, like the
      * IO thread).
      */

server/src/main/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthResponse.java

@@ -123,7 +123,7 @@ public int getDelayedUnassignedShards() {
     }
 
     /**
-     * <tt>true</tt> if the waitForXXX has timeout out and did not match.
+     * {@code true} if the waitForXXX has timeout out and did not match.
      */
     public boolean isTimedOut() {
         return this.timedOut;

server/src/main/java/org/elasticsearch/action/admin/cluster/reroute/ClusterRerouteRequest.java

@@ -51,7 +51,7 @@ public ClusterRerouteRequest add(AllocationCommand... commands) {
     }
 
     /**
-     * Sets a dry run flag (defaults to <tt>false</tt>) allowing to run the commands without
+     * Sets a dry run flag (defaults to {@code false}) allowing to run the commands without
      * actually applying them to the cluster state, and getting the resulting cluster state back.
      */
     public ClusterRerouteRequest dryRun(boolean dryRun) {
@@ -78,7 +78,7 @@ public ClusterRerouteRequest explain(boolean explain) {
     }
 
     /**
-     * Sets the retry failed flag (defaults to <tt>false</tt>). If true, the
+     * Sets the retry failed flag (defaults to {@code false}). If true, the
      * request will retry allocating shards that can't currently be allocated due to too many allocation failures.
      */
     public ClusterRerouteRequest setRetryFailed(boolean retryFailed) {

server/src/main/java/org/elasticsearch/action/admin/cluster/reroute/ClusterRerouteRequestBuilder.java

@@ -42,7 +42,7 @@ public ClusterRerouteRequestBuilder add(AllocationCommand... commands) {
     }
 
     /**
-     * Sets a dry run flag (defaults to <tt>false</tt>) allowing to run the commands without
+     * Sets a dry run flag (defaults to {@code false}) allowing to run the commands without
      * actually applying them to the cluster state, and getting the resulting cluster state back.
      */
     public ClusterRerouteRequestBuilder setDryRun(boolean dryRun) {
@@ -51,7 +51,7 @@ public ClusterRerouteRequestBuilder setDryRun(boolean dryRun) {
     }
 
     /**
-     * Sets the explain flag (defaults to <tt>false</tt>). If true, the
+     * Sets the explain flag (defaults to {@code false}). If true, the
      * request will include an explanation in addition to the cluster state.
      */
     public ClusterRerouteRequestBuilder setExplain(boolean explain) {
@@ -60,7 +60,7 @@ public ClusterRerouteRequestBuilder setExplain(boolean explain) {
     }
 
     /**
-     * Sets the retry failed flag (defaults to <tt>false</tt>). If true, the
+     * Sets the retry failed flag (defaults to {@code false}). If true, the
      * request will retry allocating shards that can't currently be allocated due to too many allocation failures.
      */
     public ClusterRerouteRequestBuilder setRetryFailed(boolean retryFailed) {

server/src/main/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequest.java

@@ -110,7 +110,7 @@ public ClusterSearchShardsRequest routing(String... routings) {
 
     /**
      * Sets the preference to execute the search. Defaults to randomize across shards. Can be set to
-     * <tt>_local</tt> to prefer local shards, <tt>_primary</tt> to execute only on primary shards, or
+     * {@code _local} to prefer local shards, {@code _primary} to execute only on primary shards, or
      * a custom value, which guarantees that the same order will be used across different requests.
      */
     public ClusterSearchShardsRequest preference(String preference) {