This is an automated email from the ASF dual-hosted git repository.
zhengruifeng pushed a commit to branch branch-4.x
in repository https://gitbox.apache.org/repos/asf/spark.git
The following commit(s) were added to refs/heads/branch-4.x by this push:
new 4a9fedda37f0 [SPARK-58436][SQL][DOC] Add missing @since tags in
functions.scala
4a9fedda37f0 is described below
commit 4a9fedda37f0e7e6e6a1c511de3149c509b061c5
Author: Uros Bojanic <[email protected]>
AuthorDate: Fri Jul 31 11:55:55 2026 +0800
[SPARK-58436][SQL][DOC] Add missing @since tags in functions.scala
### What changes were proposed in this pull request?
Adds missing `since` tags to the four `group`-documented functions in the
shared SQL functions API (`functions.scala`) that lacked one: `expr` (1.5.0),
`substring_index` (1.5.0), and both `udaf(Aggregator)` overloads (3.0.0).
### Why are the changes needed?
Every other public function in `functions.scala` carries an `since` tag;
these four were the only `group`-documented outliers. Versions were confirmed
against each function's originating commit / first release tag and the
corresponding Python `versionadded`. After this change no `group`-documented
function in the file is missing `since`
### Does this PR introduce _any_ user-facing change?
No (scaladoc only; no signature change).
### How was this patch tested?
Doc-only change. No tests needed.
### Was this patch authored or co-authored using generative AI tooling?
Generated-by: Claude Code (Opus 4.8)
Closes #57643 from uros-b/apidoc-functions-expr-since.
Authored-by: Uros Bojanic <[email protected]>
Signed-off-by: Ruifeng Zheng <[email protected]>
(cherry picked from commit 256d453a0074a8dc7b58e7d548653e52a87d98d4)
Signed-off-by: Ruifeng Zheng <[email protected]>
---
sql/api/src/main/scala/org/apache/spark/sql/functions.scala | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/sql/api/src/main/scala/org/apache/spark/sql/functions.scala
b/sql/api/src/main/scala/org/apache/spark/sql/functions.scala
index 3c026ec8e2e3..c7779aa99c10 100644
--- a/sql/api/src/main/scala/org/apache/spark/sql/functions.scala
+++ b/sql/api/src/main/scala/org/apache/spark/sql/functions.scala
@@ -4904,6 +4904,7 @@ object functions {
* }}}
*
* @group normal_funcs
+ * @since 1.5.0
*/
def expr(expr: String): Column = Column(internal.SqlExpression(expr))
@@ -8412,6 +8413,7 @@ object functions {
* @param count
* number of occurrences. A column that evaluates to an integral. Must be
a constant.
* @group string_funcs
+ * @since 1.5.0
* @return
* Returns a column that evaluates to a string.
*/
@@ -16978,6 +16980,7 @@ object functions {
* a UserDefinedFunction that can be used as an aggregating expression.
*
* @group udf_funcs
+ * @since 3.0.0
* @note
* The input encoder is inferred from the input type IN.
*/
@@ -17016,6 +17019,7 @@ object functions {
* a UserDefinedFunction that can be used as an aggregating expression
*
* @group udf_funcs
+ * @since 3.0.0
* @note
* This overloading takes an explicit input encoder, to support UDAF
declarations in Java.
*/
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]