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]

Reply via email to