[codegen] Update to latest API spec

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

@@ -34,8 +34,14 @@
  */
 @JsonpDeserializable
 public enum GeoDistanceType implements JsonEnum {
+ /**
+ * The <code>arc</code> calculation is the most accurate.
+ */
  Arc("arc"),
 
+ /**
+ * The <code>plane</code> calculation is faster but less accurate.
+ */
  Plane("plane"),
 
  ;

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

@@ -65,14 +65,18 @@ public static LatLonGeoLocation of(Function<Builder, ObjectBuilder<LatLonGeoLoca
  }
 
  /**
- * Required - API name: {@code lat}
+ * Required - Latitude
+ * <p>
+ * API name: {@code lat}
  */
  public final double lat() {
  return this.lat;
  }
 
  /**
- * Required - API name: {@code lon}
+ * Required - Longitude
+ * <p>
+ * API name: {@code lon}
  */
  public final double lon() {
  return this.lon;
@@ -114,15 +118,19 @@ public static class Builder extends WithJsonObjectBuilderBase<Builder> implement
  private Double lon;
 
  /**
- * Required - API name: {@code lat}
+ * Required - Latitude
+ * <p>
+ * API name: {@code lat}
  */
  public final Builder lat(double value) {
  this.lat = value;
  return this;
  }
 
  /**
- * Required - API name: {@code lon}
+ * Required - Longitude
+ * <p>
+ * API name: {@code lon}
  */
  public final Builder lon(double value) {
  this.lon = value;

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

@@ -72,6 +72,8 @@ public static AggregationRange of(Function<Builder, ObjectBuilder<AggregationRan
  }
 
  /**
+ * Start of the range (inclusive).
+ * <p>
  * API name: {@code from}
  */
  @Nullable
@@ -80,6 +82,8 @@ public final String from() {
  }
 
  /**
+ * Custom key to return the range with.
+ * <p>
  * API name: {@code key}
  */
  @Nullable
@@ -88,6 +92,8 @@ public final String key() {
  }
 
  /**
+ * End of the range (exclusive).
+ * <p>
  * API name: {@code to}
  */
  @Nullable
@@ -146,6 +152,8 @@ public static class Builder extends WithJsonObjectBuilderBase<Builder> implement
  private String to;
 
  /**
+ * Start of the range (inclusive).
+ * <p>
  * API name: {@code from}
  */
  public final Builder from(@Nullable String value) {
@@ -154,6 +162,8 @@ public final Builder from(@Nullable String value) {
  }
 
  /**
+ * Custom key to return the range with.
+ * <p>
  * API name: {@code key}
  */
  public final Builder key(@Nullable String value) {
@@ -162,6 +172,8 @@ public final Builder key(@Nullable String value) {
  }
 
  /**
+ * End of the range (exclusive).
+ * <p>
  * API name: {@code to}
  */
  public final Builder to(@Nullable String value) {

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

@@ -70,9 +70,9 @@ public Aggregation.Kind _aggregationKind() {
  }
 
  /**
- * Controls memory usage and approximation error by limiting the maximum number
- * of nodes used by the underlying TDigest algorithm to
- * <code>20 * compression</code>.
+ * Limits the maximum number of nodes used by the underlying TDigest algorithm
+ * to <code>20 * compression</code>, enabling control of memory usage and
+ * approximation error.
  * <p>
  * API name: {@code compression}
  */
@@ -105,9 +105,9 @@ public static class Builder extends MetricAggregationBase.AbstractBuilder<Builde
  private Double compression;
 
  /**
- * Controls memory usage and approximation error by limiting the maximum number
- * of nodes used by the underlying TDigest algorithm to
- * <code>20 * compression</code>.
+ * Limits the maximum number of nodes used by the underlying TDigest algorithm
+ * to <code>20 * compression</code>, enabling control of memory usage and
+ * approximation error.
  * <p>
  * API name: {@code compression}
  */

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

@@ -36,19 +36,19 @@
 @JsonpDeserializable
 public enum CardinalityExecutionMode implements JsonEnum {
  /**
- * Run aggregation by using global ordinals of the field and resolving those
+ * Run the aggregation by using global ordinals of the field and resolving those
  * values after finishing a shard.
  */
  GlobalOrdinals("global_ordinals"),
 
  /**
- * Run aggregation by using segment ordinal values and resolving those values
- * after each segment.
+ * Run the aggregation by using segment ordinal values and resolving those
+ * values after each segment.
  */
  SegmentOrdinals("segment_ordinals"),
 
  /**
- * Run aggregation by using field values directly.
+ * Run the aggregation by using field values directly.
  */
  Direct("direct"),
 

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

@@ -214,7 +214,7 @@ public final Integer size() {
  }
 
  /**
- * The minimum number of documents for a bucket to be returned to the results.
+ * The minimum number of documents in a bucket to be returned to the results.
  * <p>
  * API name: {@code min_doc_count}
  */
@@ -224,7 +224,7 @@ public final Integer minDocCount() {
  }
 
  /**
- * The minimum number of documents for a bucket to be returned from the shard
+ * The minimum number of documents in a bucket to be returned from the shard
  * before merging.
  * <p>
  * API name: {@code shard_min_doc_count}
@@ -475,7 +475,7 @@ public final Builder size(@Nullable Integer value) {
  }
 
  /**
- * The minimum number of documents for a bucket to be returned to the results.
+ * The minimum number of documents in a bucket to be returned to the results.
  * <p>
  * API name: {@code min_doc_count}
  */
@@ -485,7 +485,7 @@ public final Builder minDocCount(@Nullable Integer value) {
  }
 
  /**
- * The minimum number of documents for a bucket to be returned from the shard
+ * The minimum number of documents in a bucket to be returned from the shard
  * before merging.
  * <p>
  * API name: {@code shard_min_doc_count}

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

@@ -67,14 +67,21 @@ public static ChiSquareHeuristic of(Function<Builder, ObjectBuilder<ChiSquareHeu
  }
 
  /**
- * Required - API name: {@code background_is_superset}
+ * Required - Set to <code>false</code> if you defined a custom background
+ * filter that represents a different set of documents that you want to compare
+ * to.
+ * <p>
+ * API name: {@code background_is_superset}
  */
  public final boolean backgroundIsSuperset() {
  return this.backgroundIsSuperset;
  }
 
  /**
- * Required - API name: {@code include_negatives}
+ * Required - Set to <code>false</code> to filter out the terms that appear less
+ * often in the subset than in documents outside the subset.
+ * <p>
+ * API name: {@code include_negatives}
  */
  public final boolean includeNegatives() {
  return this.includeNegatives;
@@ -118,15 +125,22 @@ public static class Builder extends WithJsonObjectBuilderBase<Builder>
  private Boolean includeNegatives;
 
  /**
- * Required - API name: {@code background_is_superset}
+ * Required - Set to <code>false</code> if you defined a custom background
+ * filter that represents a different set of documents that you want to compare
+ * to.
+ * <p>
+ * API name: {@code background_is_superset}
  */
  public final Builder backgroundIsSuperset(boolean value) {
  this.backgroundIsSuperset = value;
  return this;
  }
 
  /**
- * Required - API name: {@code include_negatives}
+ * Required - Set to <code>false</code> to filter out the terms that appear less
+ * often in the subset than in documents outside the subset.
+ * <p>
+ * API name: {@code include_negatives}
  */
  public final Builder includeNegatives(boolean value) {
  this.includeNegatives = value;

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

@@ -255,7 +255,7 @@ public final Time offset() {
  }
 
  /**
- * The order of the returned buckets.
+ * The sort order of the returned buckets.
  * <p>
  * API name: {@code order}
  */
@@ -291,7 +291,7 @@ public final String timeZone() {
 
  /**
  * Set to <code>true</code> to associate a unique string key with each bucket
- * and returns the ranges as a hash rather than an array.
+ * and return the ranges as a hash rather than an array.
  * <p>
  * API name: {@code keyed}
  */
@@ -609,7 +609,7 @@ public final Builder offset(Function<Time.Builder, ObjectBuilder<Time>> fn) {
  }
 
  /**
- * The order of the returned buckets.
+ * The sort order of the returned buckets.
  * <p>
  * API name: {@code order}
  * <p>
@@ -621,7 +621,7 @@ public final Builder order(List<NamedValue<SortOrder>> list) {
  }
 
  /**
- * The order of the returned buckets.
+ * The sort order of the returned buckets.
  * <p>
  * API name: {@code order}
  * <p>
@@ -680,7 +680,7 @@ public final Builder timeZone(@Nullable String value) {
 
  /**
  * Set to <code>true</code> to associate a unique string key with each bucket
- * and returns the ranges as a hash rather than an array.
+ * and return the ranges as a hash rather than an array.
  * <p>
  * API name: {@code keyed}
  */

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

@@ -72,7 +72,7 @@ public static DateRangeExpression of(Function<Builder, ObjectBuilder<DateRangeEx
  }
 
  /**
- * Start of the range.
+ * Start of the range (inclusive).
  * <p>
  * API name: {@code from}
  */
@@ -92,7 +92,7 @@ public final String key() {
  }
 
  /**
- * End of the range.
+ * End of the range (exclusive).
  * <p>
  * API name: {@code to}
  */
@@ -154,7 +154,7 @@ public static class Builder extends WithJsonObjectBuilderBase<Builder>
  private FieldDateMath to;
 
  /**
- * Start of the range.
+ * Start of the range (inclusive).
  * <p>
  * API name: {@code from}
  */
@@ -164,7 +164,7 @@ public final Builder from(@Nullable FieldDateMath value) {
  }
 
  /**
- * Start of the range.
+ * Start of the range (inclusive).
  * <p>
  * API name: {@code from}
  */
@@ -183,7 +183,7 @@ public final Builder key(@Nullable String value) {
  }
 
  /**
- * End of the range.
+ * End of the range (exclusive).
  * <p>
  * API name: {@code to}
  */
@@ -193,7 +193,7 @@ public final Builder to(@Nullable FieldDateMath value) {
  }
 
  /**
- * End of the range.
+ * End of the range (exclusive).
  * <p>
  * API name: {@code to}
  */

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

@@ -73,14 +73,18 @@ public static <T> ExtendedBounds<T> of(Function<Builder<T>, ObjectBuilder<Extend
  }
 
  /**
- * Required - API name: {@code max}
+ * Required - Maximum value for the bound.
+ * <p>
+ * API name: {@code max}
  */
  public final T max() {
  return this.max;
  }
 
  /**
- * Required - API name: {@code min}
+ * Required - Minimum value for the bound.
+ * <p>
+ * API name: {@code min}
  */
  public final T min() {
  return this.min;
@@ -127,15 +131,19 @@ public static class Builder<T> extends WithJsonObjectBuilderBase<Builder<T>>
  private JsonpSerializer<T> tSerializer;
 
  /**
- * Required - API name: {@code max}
+ * Required - Maximum value for the bound.
+ * <p>
+ * API name: {@code max}
  */
  public final Builder<T> max(T value) {
  this.max = value;
  return this;
  }
 
  /**
- * Required - API name: {@code min}
+ * Required - Minimum value for the bound.
+ * <p>
+ * API name: {@code min}
  */
  public final Builder<T> min(T value) {
  this.min = value;