Add XML doc comments for enums

Author: stevejgordon

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.Aggregations.g.cs

@@ -182,10 +182,19 @@ public override void Write(Utf8JsonWriter writer, CardinalityExecutionMode value
 [JsonConverter(typeof(GapPolicyConverter))]
 public enum GapPolicy
 {
+	/// <summary>
+	/// <para>Treats missing data as if the bucket does not exist. It will skip the bucket and<br/>continue calculating using the next available value.</para>
+	/// </summary>
 	[EnumMember(Value = "skip")]
 	Skip,
+	/// <summary>
+	/// <para>Similar to skip, except if the metric provides a non-null, non-NaN value this value is used,<br/>otherwise the empty bucket is skipped.</para>
+	/// </summary>
 	[EnumMember(Value = "keep_values")]
 	KeepValues,
+	/// <summary>
+	/// <para>Replace missing values with a zero (0) and pipeline aggregation computation will proceed as normal.</para>
+	/// </summary>
 	[EnumMember(Value = "insert_zeros")]
 	InsertZeros
 }

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.Core.Search.g.cs

@@ -415,8 +415,14 @@ public override void Write(Utf8JsonWriter writer, SuggestSort value, JsonSeriali
 [JsonConverter(typeof(TotalHitsRelationConverter))]
 public enum TotalHitsRelation
 {
+	/// <summary>
+	/// <para>Lower bound, including returned events or sequences</para>
+	/// </summary>
 	[EnumMember(Value = "gte")]
 	Gte,
+	/// <summary>
+	/// <para>Accurate</para>
+	/// </summary>
 	[EnumMember(Value = "eq")]
 	Eq
 }

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.Eql.g.cs

@@ -29,8 +29,14 @@ namespace Elastic.Clients.Elasticsearch.Eql;
 [JsonConverter(typeof(ResultPositionConverter))]
 public enum ResultPosition
 {
+	/// <summary>
+	/// <para>Return the most recent matches, similar to the Unix tail command.</para>
+	/// </summary>
 	[EnumMember(Value = "tail")]
 	Tail,
+	/// <summary>
+	/// <para>Return the earliest matches, similar to the Unix head command.</para>
+	/// </summary>
 	[EnumMember(Value = "head")]
 	Head
 }

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.IndexManagement.g.cs

@@ -502,9 +502,25 @@ public readonly partial struct StorageType
 	public StorageType(string value) => Value = value;
 
 	public readonly string Value { get; }
+
+	/// <summary>
+	/// <para>The NIO FS type stores the shard index on the file system (maps to Lucene NIOFSDirectory) using NIO. It allows multiple<br/>threads to read from the same file concurrently. It is not recommended on Windows because of a bug in the SUN Java<br/>implementation and disables some optimizations for heap memory usage.</para>
+	/// </summary>
 	public static StorageType Niofs { get; } = new StorageType("niofs");
+
+	/// <summary>
+	/// <para>The MMap FS type stores the shard index on the file system (maps to Lucene MMapDirectory) by mapping a file into<br/>memory (mmap). Memory mapping uses up a portion of the virtual memory address space in your process equal to the size<br/>of the file being mapped. Before using this class, be sure you have allowed plenty of virtual address space.</para>
+	/// </summary>
 	public static StorageType Mmapfs { get; } = new StorageType("mmapfs");
+
+	/// <summary>
+	/// <para>The hybridfs type is a hybrid of niofs and mmapfs, which chooses the best file system type for each type of file<br/>based on the read access pattern. Currently only the Lucene term dictionary, norms and doc values files are memory<br/>mapped. All other files are opened using Lucene NIOFSDirectory. Similarly to mmapfs be sure you have allowed<br/>plenty of virtual address space.</para>
+	/// </summary>
 	public static StorageType Hybridfs { get; } = new StorageType("hybridfs");
+
+	/// <summary>
+	/// <para>Default file system implementation. This will pick the best implementation depending on the operating environment, which<br/>is currently hybridfs on all supported systems but is subject to change.</para>
+	/// </summary>
 	public static StorageType Fs { get; } = new StorageType("fs");
 
 	public override string ToString() => Value ?? string.Empty;
@@ -523,8 +539,14 @@ public readonly partial struct StorageType
 [JsonConverter(typeof(TranslogDurabilityConverter))]
 public enum TranslogDurability
 {
+	/// <summary>
+	/// <para>(default) fsync and commit after every request. In the event of hardware failure, all acknowledged writes<br/>will already have been committed to disk.</para>
+	/// </summary>
 	[EnumMember(Value = "request")]
 	Request,
+	/// <summary>
+	/// <para>fsync and commit in the background every sync_interval. In the event of a failure, all acknowledged writes<br/>since the last automatic commit will be discarded.</para>
+	/// </summary>
 	[EnumMember(Value = "async")]
 	Async
 }

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.Ingest.g.cs

@@ -105,8 +105,14 @@ public override void Write(Utf8JsonWriter writer, ConvertType value, JsonSeriali
 [JsonConverter(typeof(JsonProcessorConflictStrategyConverter))]
 public enum JsonProcessorConflictStrategy
 {
+	/// <summary>
+	/// <para>Root fields that conflict with fields from the parsed JSON will be overridden.</para>
+	/// </summary>
 	[EnumMember(Value = "replace")]
 	Replace,
+	/// <summary>
+	/// <para>Conflicting fields will be merged.</para>
+	/// </summary>
 	[EnumMember(Value = "merge")]
 	Merge
 }

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.Mapping.g.cs

@@ -706,6 +706,9 @@ public override void Write(Utf8JsonWriter writer, RuntimeFieldType value, JsonSe
 [JsonConverter(typeof(SourceFieldModeConverter))]
 public enum SourceFieldMode
 {
+	/// <summary>
+	/// <para>Instead of storing source documents on disk exactly as you send them,<br/> Elasticsearch can reconstruct source content on the fly upon retrieval.</para>
+	/// </summary>
 	[EnumMember(Value = "synthetic")]
 	Synthetic,
 	[EnumMember(Value = "stored")]

src/Elastic.Clients.Elasticsearch/_Generated/Types/Enums/Enums.NoNamespace.g.cs

@@ -332,14 +332,29 @@ public override void Write(Utf8JsonWriter writer, DistanceUnit value, JsonSerial
 [JsonConverter(typeof(ExpandWildcardConverter))]
 public enum ExpandWildcard
 {
+	/// <summary>
+	/// <para>Match open, non-hidden indices. Also matches any non-hidden data stream.</para>
+	/// </summary>
 	[EnumMember(Value = "open")]
 	Open,
+	/// <summary>
+	/// <para>Wildcard expressions are not accepted.</para>
+	/// </summary>
 	[EnumMember(Value = "none")]
 	None,
+	/// <summary>
+	/// <para>Match hidden data streams and hidden indices. Must be combined with open, closed, or both.</para>
+	/// </summary>
 	[EnumMember(Value = "hidden")]
 	Hidden,
+	/// <summary>
+	/// <para>Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.</para>
+	/// </summary>
 	[EnumMember(Value = "closed")]
 	Closed,
+	/// <summary>
+	/// <para>Match any data stream or index, including hidden ones.</para>
+	/// </summary>
 	[EnumMember(Value = "all")]
 	All
 }
@@ -545,10 +560,19 @@ public override void Write(Utf8JsonWriter writer, GeoShapeRelation value, JsonSe
 [JsonConverter(typeof(HealthStatusConverter))]
 public enum HealthStatus
 {
+	/// <summary>
+	/// <para>All primary shards are assigned, but one or more replica shards are unassigned. If a node in the cluster fails, some data could be unavailable until that node is repaired.</para>
+	/// </summary>
 	[EnumMember(Value = "yellow")]
 	Yellow,
+	/// <summary>
+	/// <para>One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.</para>
+	/// </summary>
 	[EnumMember(Value = "red")]
 	Red,
+	/// <summary>
+	/// <para>All shards are assigned.</para>
+	/// </summary>
 	[EnumMember(Value = "green")]
 	Green
 }
@@ -1047,8 +1071,14 @@ public override void Write(Utf8JsonWriter writer, ScriptSortType value, JsonSeri
 [JsonConverter(typeof(SearchTypeConverter))]
 public enum SearchType
 {
+	/// <summary>
+	/// <para>Documents are scored using local term and document frequencies for the shard. This is usually faster but less accurate.</para>
+	/// </summary>
 	[EnumMember(Value = "query_then_fetch")]
 	QueryThenFetch,
+	/// <summary>
+	/// <para>Documents are scored using global term and document frequencies across all shards. This is usually slower but more accurate.</para>
+	/// </summary>
 	[EnumMember(Value = "dfs_query_then_fetch")]
 	DfsQueryThenFetch
 }
@@ -1088,6 +1118,9 @@ public override void Write(Utf8JsonWriter writer, SearchType value, JsonSerializ
 [JsonConverter(typeof(SlicesCalculationConverter))]
 public enum SlicesCalculation
 {
+	/// <summary>
+	/// <para>Let Elasticsearch choose a reasonable number for most data streams and indices.</para>
+	/// </summary>
 	[EnumMember(Value = "auto")]
 	Auto
 }