ESQL: Generate a few more docs (elastic#106577)

And improve the error message on csv test failures.
astefan · Mar 21, 2024 · 3489906 · 3489906
1 parent 49d40c3
commit 3489906
Show file tree

Hide file tree

Showing 254 changed files with 361 additions and 374 deletions.
diff --git a/docs/reference/esql/functions/asin.asciidoc b/docs/reference/esql/functions/asin.asciidoc
diff --git a/docs/reference/esql/functions/atan.asciidoc b/docs/reference/esql/functions/atan.asciidoc
diff --git a/docs/reference/esql/functions/atan2.asciidoc b/docs/reference/esql/functions/atan2.asciidoc
diff --git a/docs/reference/esql/functions/description/abs.asciidoc b/docs/reference/esql/functions/description/abs.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/acos.asciidoc b/docs/reference/esql/functions/description/acos.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/asin.asciidoc b/docs/reference/esql/functions/description/asin.asciidoc
@@ -1,5 +1,5 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 
-Inverse sine trigonometric function.
+Returns the {wikipedia}/Inverse_trigonometric_functions[arcsine] of the input numeric expression as an angle, expressed in radians.
diff --git a/docs/reference/esql/functions/description/atan.asciidoc b/docs/reference/esql/functions/description/atan.asciidoc
@@ -1,5 +1,5 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 
-Inverse tangent trigonometric function.
+Returns the {wikipedia}/Inverse_trigonometric_functions[arctangent] of the input numeric expression as an angle, expressed in radians.
diff --git a/docs/reference/esql/functions/description/atan2.asciidoc b/docs/reference/esql/functions/description/atan2.asciidoc
@@ -1,5 +1,5 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 
-The angle between the positive x-axis and the ray from the origin to the point (x , y) in the Cartesian plane.
+The {wikipedia}/Atan2[angle] between the positive x-axis and the ray from the origin to the point (x , y) in the Cartesian plane, expressed in radians.
diff --git a/docs/reference/esql/functions/description/auto_bucket.asciidoc b/docs/reference/esql/functions/description/auto_bucket.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/case.asciidoc b/docs/reference/esql/functions/description/case.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/ceil.asciidoc b/docs/reference/esql/functions/description/ceil.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/coalesce.asciidoc b/docs/reference/esql/functions/description/coalesce.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/concat.asciidoc b/docs/reference/esql/functions/description/concat.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/cos.asciidoc b/docs/reference/esql/functions/description/cos.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/cosh.asciidoc b/docs/reference/esql/functions/description/cosh.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/date_diff.asciidoc b/docs/reference/esql/functions/description/date_diff.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/date_extract.asciidoc b/docs/reference/esql/functions/description/date_extract.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/date_parse.asciidoc b/docs/reference/esql/functions/description/date_parse.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/e.asciidoc b/docs/reference/esql/functions/description/e.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/ends_with.asciidoc b/docs/reference/esql/functions/description/ends_with.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/floor.asciidoc b/docs/reference/esql/functions/description/floor.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/greatest.asciidoc b/docs/reference/esql/functions/description/greatest.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/least.asciidoc b/docs/reference/esql/functions/description/least.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/left.asciidoc b/docs/reference/esql/functions/description/left.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/length.asciidoc b/docs/reference/esql/functions/description/length.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/log.asciidoc b/docs/reference/esql/functions/description/log.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/log10.asciidoc b/docs/reference/esql/functions/description/log10.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/ltrim.asciidoc b/docs/reference/esql/functions/description/ltrim.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_avg.asciidoc b/docs/reference/esql/functions/description/mv_avg.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_concat.asciidoc b/docs/reference/esql/functions/description/mv_concat.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_count.asciidoc b/docs/reference/esql/functions/description/mv_count.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_dedupe.asciidoc b/docs/reference/esql/functions/description/mv_dedupe.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_first.asciidoc b/docs/reference/esql/functions/description/mv_first.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_last.asciidoc b/docs/reference/esql/functions/description/mv_last.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_max.asciidoc b/docs/reference/esql/functions/description/mv_max.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_median.asciidoc b/docs/reference/esql/functions/description/mv_median.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_min.asciidoc b/docs/reference/esql/functions/description/mv_min.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_slice.asciidoc b/docs/reference/esql/functions/description/mv_slice.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_sort.asciidoc b/docs/reference/esql/functions/description/mv_sort.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_sum.asciidoc b/docs/reference/esql/functions/description/mv_sum.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/mv_zip.asciidoc b/docs/reference/esql/functions/description/mv_zip.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/pi.asciidoc b/docs/reference/esql/functions/description/pi.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/pow.asciidoc b/docs/reference/esql/functions/description/pow.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/replace.asciidoc b/docs/reference/esql/functions/description/replace.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/right.asciidoc b/docs/reference/esql/functions/description/right.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/round.asciidoc b/docs/reference/esql/functions/description/round.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/rtrim.asciidoc b/docs/reference/esql/functions/description/rtrim.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/sin.asciidoc b/docs/reference/esql/functions/description/sin.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/sinh.asciidoc b/docs/reference/esql/functions/description/sinh.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/split.asciidoc b/docs/reference/esql/functions/description/split.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/sqrt.asciidoc b/docs/reference/esql/functions/description/sqrt.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*
 

diff --git a/docs/reference/esql/functions/description/st_intersects.asciidoc b/docs/reference/esql/functions/description/st_intersects.asciidoc
@@ -1,4 +1,4 @@
-// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it.
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
 
 *Description*