Merge branch 'main' into lucene_snapshot_10_1

Author: ChrisHegarty

docs/changelog/120360.yaml

@@ -0,0 +1,5 @@
+pr: 120360
+summary: ESQL - Add Match function options
+area: ES|QL
+type: feature
+issues: []

docs/changelog/120725.yaml

@@ -0,0 +1,7 @@
+pr: 120725
+summary: |-
+  A new query parameter `?include_source_on_error` was added for create / index, update and bulk REST APIs to control
+  if to include the document source in the error response in case of parsing errors. The default value is `true`.
+area: Infra/REST API
+type: enhancement
+issues: []

docs/changelog/120959.yaml

@@ -0,0 +1,5 @@
+pr: 120959
+summary: Remove unnecessary entitlement
+area: Infra/Plugins
+type: bug
+issues: []

docs/reference/esql/esql-syntax.asciidoc

@@ -169,3 +169,47 @@ Timespan literals are not whitespace sensitive. These expressions are all valid:
 * `1 day`
 * `1       day`
 
+[discrete]
+[[esql-function-named-params]]
+==== Function named parameters
+
+Some functions like <<esql-match,match>> use named parameters to provide additional options.
+
+Named parameters allow specifying name value pairs, using the following syntax:
+
+`{"option_name": option_value, "another_option_name": another_value}`
+
+Valid value types are strings, numbers and booleans.
+
+An example using <<esql-match,match>>:
+
+[source,console]
+----
+POST /_query
+{
+"query": """
+FROM library
+| WHERE match(author, "Frank Herbert", {"minimum_should_match": 2, "operator": "AND"})
+| LIMIT 5
+"""
+}
+----
+// TEST[setup:library]
+
+You can also use <<esql-rest-params,query parameters>> in function named parameters:
+
+[source,console]
+----
+POST /_query
+{
+"query": """
+FROM library
+| EVAL year = DATE_EXTRACT("year", release_date)
+| WHERE page_count > ? AND match(author, ?, {"minimum_should_match": ?})
+| LIMIT 5
+""",
+"params": [300, "Frank Herbert", 2]
+}
+----
+// TEST[setup:library]
+