[codegen] update to latest spec

Author: l-trotta

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

@@ -59,7 +59,7 @@
 /**
  *
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/sort-search-results.html">Documentation
+ *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/sort-search-results.html">Documentation
  *      on elastic.co</a>
  * @see <a href="../doc-files/api-spec.html#_types.SortOptions">API
  *      specification</a>

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

@@ -57,7 +57,7 @@
 /**
  *
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/analysis-normalizers.html">Documentation
+ *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/analysis-normalizers.html">Documentation
  *      on elastic.co</a>
  * @see <a href="../../doc-files/api-spec.html#_types.analysis.Normalizer">API
  *      specification</a>

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

@@ -53,7 +53,7 @@
  * searching with arbitrary geo shapes such as rectangles and polygons.
  * 
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/geo-shape.html">Documentation
+ *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/geo-shape.html">Documentation
  *      on elastic.co</a>
  * @see <a href=
  *      "../../doc-files/api-spec.html#_types.mapping.GeoShapeProperty">API

java-client/src/main/java/co/elastic/clients/elasticsearch/_types/analysis/Normalizer.java

@@ -54,7 +54,7 @@
  * polygons.
  * 
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/shape.html">Documentation
+ *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/shape.html">Documentation
  *      on elastic.co</a>
  * @see <a href="../../doc-files/api-spec.html#_types.mapping.ShapeProperty">API
  *      specification</a>

java-client/src/main/java/co/elastic/clients/elasticsearch/_types/mapping/GeoShapeProperty.java

@@ -60,7 +60,7 @@
  * the text.
  * 
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/query-dsl-mlt-query.html#_document_input_parameters">Documentation
+ *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/query-dsl-mlt-query.html#_document_input_parameters">Documentation
  *      on elastic.co</a>
  * @see <a href="../../doc-files/api-spec.html#_types.query_dsl.Like">API
  *      specification</a>

java-client/src/main/java/co/elastic/clients/elasticsearch/_types/mapping/ShapeProperty.java

@@ -62,9 +62,6 @@
 /**
  *
  * @see <a href=
- *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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/_types/query_dsl/Like.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

@@ -71,15 +71,15 @@ public ElasticsearchAsyncSearchClient withTransportOptions(@Nullable TransportOp
 	// ----- 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/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -92,18 +92,18 @@ public DeleteAsyncSearchResponse delete(DeleteAsyncSearchRequest 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.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
 	 *            {@link DeleteAsyncSearchRequest}
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -116,13 +116,13 @@ public final 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/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -137,16 +137,16 @@ public <TDocument> GetAsyncSearchResponse<TDocument> get(GetAsyncSearchRequest r
 	}
 
 	/**
-	 * 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
 	 *            {@link GetAsyncSearchRequest}
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -157,13 +157,13 @@ public final <TDocument> GetAsyncSearchResponse<TDocument> 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/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -178,16 +178,16 @@ public <TDocument> GetAsyncSearchResponse<TDocument> get(GetAsyncSearchRequest r
 	}
 
 	/**
-	 * 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
 	 *            {@link GetAsyncSearchRequest}
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -200,13 +200,13 @@ public final <TDocument> GetAsyncSearchResponse<TDocument> get(
 	// ----- 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.
 	 * 
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -219,7 +219,7 @@ public AsyncSearchStatusResponse status(AsyncSearchStatusRequest 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.
@@ -228,7 +228,7 @@ public AsyncSearchStatusResponse status(AsyncSearchStatusRequest request)
 	 *            a function that initializes a builder to create the
 	 *            {@link AsyncSearchStatusRequest}
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -241,18 +241,22 @@ public final 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/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -268,21 +272,25 @@ public <TDocument> SubmitResponse<TDocument> submit(SubmitRequest request, Class
 	}
 
 	/**
-	 * 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
 	 *            {@link SubmitRequest}
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -293,18 +301,22 @@ public final <TDocument> 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/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */
 
@@ -320,21 +332,25 @@ public <TDocument> SubmitResponse<TDocument> submit(SubmitRequest request, Type
 	}
 
 	/**
-	 * 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
 	 *            {@link SubmitRequest}
 	 * @see <a href=
-	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/async-search.html">Documentation
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.17/async-search.html">Documentation
 	 *      on elastic.co</a>
 	 */