[codegen] update to latest spec

Author: l-trotta

java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchAsyncClient.java

@@ -62,9 +62,6 @@
 /**
  *
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/9.0/query-dsl.html">Documentation
- *      on elastic.co</a>
- * @see <a href=
  *      "../../doc-files/api-spec.html#_types.query_dsl.QueryContainer">API
  *      specification</a>
  */

java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchClient.java

@@ -56,7 +56,7 @@
 // typedef: async_search.status.Request
 
 /**
- * Get async search status Retrieves the status of a previously submitted async
+ * Get async search status. Retrieve the status of a previously submitted async
  * search request given its identifier, without retrieving search results. If
  * the Elasticsearch security features are enabled, use of this API is
  * restricted to the <code>monitoring_user</code> role.

java-client/src/main/java/co/elastic/clients/elasticsearch/_types/query_dsl/Query.java

@@ -56,12 +56,12 @@
 // typedef: async_search.delete.Request
 
 /**
- * Deletes an async search by identifier. If the search is still running, the
- * search request will be cancelled. Otherwise, the saved search results are
- * deleted. If the Elasticsearch security features are enabled, the deletion of
- * a specific async search is restricted to: the authenticated user that
- * submitted the original search request; users that have the
- * <code>cancel_task</code> cluster privilege.
+ * Delete an async search. If the asynchronous search is still running, it is
+ * cancelled. Otherwise, the saved search results are deleted. If the
+ * Elasticsearch security features are enabled, the deletion of a specific async
+ * search is restricted to: the authenticated user that submitted the original
+ * search request; users that have the <code>cancel_task</code> cluster
+ * privilege.
  * 
  * @see <a href="../doc-files/api-spec.html#async_search.delete.Request">API
  *      specification</a>

java-client/src/main/java/co/elastic/clients/elasticsearch/async_search/AsyncSearchStatusRequest.java

@@ -72,12 +72,12 @@ public ElasticsearchAsyncSearchAsyncClient withTransportOptions(@Nullable Transp
 	// ----- Endpoint: async_search.delete
 
 	/**
-	 * Deletes an async search by identifier. If the search is still running, the
-	 * search request will be cancelled. Otherwise, the saved search results are
-	 * deleted. If the Elasticsearch security features are enabled, the deletion of
-	 * a specific async search is restricted to: the authenticated user that
-	 * submitted the original search request; users that have the
-	 * <code>cancel_task</code> cluster privilege.
+	 * Delete an async search. If the asynchronous search is still running, it is
+	 * cancelled. Otherwise, the saved search results are deleted. If the
+	 * Elasticsearch security features are enabled, the deletion of a specific async
+	 * search is restricted to: the authenticated user that submitted the original
+	 * search request; users that have the <code>cancel_task</code> cluster
+	 * privilege.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/9.0/async-search.html">Documentation
@@ -92,12 +92,12 @@ public CompletableFuture<DeleteAsyncSearchResponse> delete(DeleteAsyncSearchRequ
 	}
 
 	/**
-	 * Deletes an async search by identifier. If the search is still running, the
-	 * search request will be cancelled. Otherwise, the saved search results are
-	 * deleted. If the Elasticsearch security features are enabled, the deletion of
-	 * a specific async search is restricted to: the authenticated user that
-	 * submitted the original search request; users that have the
-	 * <code>cancel_task</code> cluster privilege.
+	 * Delete an async search. If the asynchronous search is still running, it is
+	 * cancelled. Otherwise, the saved search results are deleted. If the
+	 * Elasticsearch security features are enabled, the deletion of a specific async
+	 * search is restricted to: the authenticated user that submitted the original
+	 * search request; users that have the <code>cancel_task</code> cluster
+	 * privilege.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -115,10 +115,10 @@ public final CompletableFuture<DeleteAsyncSearchResponse> delete(
 	// ----- Endpoint: async_search.get
 
 	/**
-	 * Retrieves the results of a previously submitted async search request given
-	 * its identifier. If the Elasticsearch security features are enabled, access to
-	 * the results of a specific async search is restricted to the user or API key
-	 * that submitted it.
+	 * Get async search results. Retrieve the results of a previously submitted
+	 * asynchronous search request. If the Elasticsearch security features are
+	 * enabled, access to the results of a specific async search is restricted to
+	 * the user or API key that submitted it.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/9.0/async-search.html">Documentation
@@ -136,10 +136,10 @@ public <TDocument> CompletableFuture<GetAsyncSearchResponse<TDocument>> get(GetA
 	}
 
 	/**
-	 * Retrieves the results of a previously submitted async search request given
-	 * its identifier. If the Elasticsearch security features are enabled, access to
-	 * the results of a specific async search is restricted to the user or API key
-	 * that submitted it.
+	 * Get async search results. Retrieve the results of a previously submitted
+	 * asynchronous search request. If the Elasticsearch security features are
+	 * enabled, access to the results of a specific async search is restricted to
+	 * the user or API key that submitted it.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -156,10 +156,10 @@ public final <TDocument> CompletableFuture<GetAsyncSearchResponse<TDocument>> ge
 	}
 
 	/**
-	 * Retrieves the results of a previously submitted async search request given
-	 * its identifier. If the Elasticsearch security features are enabled, access to
-	 * the results of a specific async search is restricted to the user or API key
-	 * that submitted it.
+	 * Get async search results. Retrieve the results of a previously submitted
+	 * asynchronous search request. If the Elasticsearch security features are
+	 * enabled, access to the results of a specific async search is restricted to
+	 * the user or API key that submitted it.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/9.0/async-search.html">Documentation
@@ -177,10 +177,10 @@ public <TDocument> CompletableFuture<GetAsyncSearchResponse<TDocument>> get(GetA
 	}
 
 	/**
-	 * Retrieves the results of a previously submitted async search request given
-	 * its identifier. If the Elasticsearch security features are enabled, access to
-	 * the results of a specific async search is restricted to the user or API key
-	 * that submitted it.
+	 * Get async search results. Retrieve the results of a previously submitted
+	 * asynchronous search request. If the Elasticsearch security features are
+	 * enabled, access to the results of a specific async search is restricted to
+	 * the user or API key that submitted it.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -198,7 +198,7 @@ public final <TDocument> CompletableFuture<GetAsyncSearchResponse<TDocument>> ge
 	// ----- Endpoint: async_search.status
 
 	/**
-	 * Get async search status Retrieves the status of a previously submitted async
+	 * Get async search status. Retrieve the status of a previously submitted async
 	 * search request given its identifier, without retrieving search results. If
 	 * the Elasticsearch security features are enabled, use of this API is
 	 * restricted to the <code>monitoring_user</code> role.
@@ -216,7 +216,7 @@ public CompletableFuture<AsyncSearchStatusResponse> status(AsyncSearchStatusRequ
 	}
 
 	/**
-	 * Get async search status Retrieves the status of a previously submitted async
+	 * Get async search status. Retrieve the status of a previously submitted async
 	 * search request given its identifier, without retrieving search results. If
 	 * the Elasticsearch security features are enabled, use of this API is
 	 * restricted to the <code>monitoring_user</code> role.
@@ -237,15 +237,19 @@ public final CompletableFuture<AsyncSearchStatusResponse> status(
 	// ----- Endpoint: async_search.submit
 
 	/**
-	 * Runs a search request asynchronously. When the primary sort of the results is
-	 * an indexed field, shards get sorted based on minimum and maximum value that
-	 * they hold for that field, hence partial results become available following
-	 * the sort criteria that was requested. Warning: Async search does not support
-	 * scroll nor search requests that only include the suggest section. By default,
-	 * Elasticsearch doesn’t allow you to store an async search response larger than
-	 * 10Mb and an attempt to do this results in an error. The maximum allowed size
-	 * for a stored async search response can be set by changing the
-	 * <code>search.max_async_search_response_size</code> cluster level setting.
+	 * Run an async search. When the primary sort of the results is an indexed
+	 * field, shards get sorted based on minimum and maximum value that they hold
+	 * for that field. Partial results become available following the sort criteria
+	 * that was requested.
+	 * <p>
+	 * Warning: Asynchronous search does not support scroll or search requests that
+	 * include only the suggest section.
+	 * <p>
+	 * By default, Elasticsearch does not allow you to store an async search
+	 * response larger than 10Mb and an attempt to do this results in an error. The
+	 * maximum allowed size for a stored async search response can be set by
+	 * changing the <code>search.max_async_search_response_size</code> cluster level
+	 * setting.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/9.0/async-search.html">Documentation
@@ -264,15 +268,19 @@ public <TDocument> CompletableFuture<SubmitResponse<TDocument>> submit(SubmitReq
 	}
 
 	/**
-	 * Runs a search request asynchronously. When the primary sort of the results is
-	 * an indexed field, shards get sorted based on minimum and maximum value that
-	 * they hold for that field, hence partial results become available following
-	 * the sort criteria that was requested. Warning: Async search does not support
-	 * scroll nor search requests that only include the suggest section. By default,
-	 * Elasticsearch doesn’t allow you to store an async search response larger than
-	 * 10Mb and an attempt to do this results in an error. The maximum allowed size
-	 * for a stored async search response can be set by changing the
-	 * <code>search.max_async_search_response_size</code> cluster level setting.
+	 * Run an async search. When the primary sort of the results is an indexed
+	 * field, shards get sorted based on minimum and maximum value that they hold
+	 * for that field. Partial results become available following the sort criteria
+	 * that was requested.
+	 * <p>
+	 * Warning: Asynchronous search does not support scroll or search requests that
+	 * include only the suggest section.
+	 * <p>
+	 * By default, Elasticsearch does not allow you to store an async search
+	 * response larger than 10Mb and an attempt to do this results in an error. The
+	 * maximum allowed size for a stored async search response can be set by
+	 * changing the <code>search.max_async_search_response_size</code> cluster level
+	 * setting.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -288,15 +296,19 @@ public final <TDocument> CompletableFuture<SubmitResponse<TDocument>> submit(
 	}
 
 	/**
-	 * Runs a search request asynchronously. When the primary sort of the results is
-	 * an indexed field, shards get sorted based on minimum and maximum value that
-	 * they hold for that field, hence partial results become available following
-	 * the sort criteria that was requested. Warning: Async search does not support
-	 * scroll nor search requests that only include the suggest section. By default,
-	 * Elasticsearch doesn’t allow you to store an async search response larger than
-	 * 10Mb and an attempt to do this results in an error. The maximum allowed size
-	 * for a stored async search response can be set by changing the
-	 * <code>search.max_async_search_response_size</code> cluster level setting.
+	 * Run an async search. When the primary sort of the results is an indexed
+	 * field, shards get sorted based on minimum and maximum value that they hold
+	 * for that field. Partial results become available following the sort criteria
+	 * that was requested.
+	 * <p>
+	 * Warning: Asynchronous search does not support scroll or search requests that
+	 * include only the suggest section.
+	 * <p>
+	 * By default, Elasticsearch does not allow you to store an async search
+	 * response larger than 10Mb and an attempt to do this results in an error. The
+	 * maximum allowed size for a stored async search response can be set by
+	 * changing the <code>search.max_async_search_response_size</code> cluster level
+	 * setting.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/9.0/async-search.html">Documentation
@@ -314,15 +326,19 @@ public <TDocument> CompletableFuture<SubmitResponse<TDocument>> submit(SubmitReq
 	}
 
 	/**
-	 * Runs a search request asynchronously. When the primary sort of the results is
-	 * an indexed field, shards get sorted based on minimum and maximum value that
-	 * they hold for that field, hence partial results become available following
-	 * the sort criteria that was requested. Warning: Async search does not support
-	 * scroll nor search requests that only include the suggest section. By default,
-	 * Elasticsearch doesn’t allow you to store an async search response larger than
-	 * 10Mb and an attempt to do this results in an error. The maximum allowed size
-	 * for a stored async search response can be set by changing the
-	 * <code>search.max_async_search_response_size</code> cluster level setting.
+	 * Run an async search. When the primary sort of the results is an indexed
+	 * field, shards get sorted based on minimum and maximum value that they hold
+	 * for that field. Partial results become available following the sort criteria
+	 * that was requested.
+	 * <p>
+	 * Warning: Asynchronous search does not support scroll or search requests that
+	 * include only the suggest section.
+	 * <p>
+	 * By default, Elasticsearch does not allow you to store an async search
+	 * response larger than 10Mb and an attempt to do this results in an error. The
+	 * maximum allowed size for a stored async search response can be set by
+	 * changing the <code>search.max_async_search_response_size</code> cluster level
+	 * setting.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the