Skip to content

[SPARK-58436][SQL][DOC] Add missing @since tags in functions.scala - #57643

Closed
uros-b wants to merge 2 commits into
apache:masterfrom
uros-b:apidoc-functions-expr-since
Closed

[SPARK-58436][SQL][DOC] Add missing @since tags in functions.scala#57643
uros-b wants to merge 2 commits into
apache:masterfrom
uros-b:apidoc-functions-expr-since

Conversation

@uros-b

@uros-b uros-b commented Jul 29, 2026

Copy link
Copy Markdown
Member

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)

@uros-b uros-b left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Waiting for CI

@uros-b
uros-b force-pushed the apidoc-functions-expr-since branch from 0ec26c2 to 5a11891 Compare July 29, 2026 22:42
@uros-b uros-b changed the title [MINOR][SQL] Add missing @since tag to functions.expr [MINOR][SQL] Add missing @since tags in functions.expr Jul 29, 2026
@uros-b uros-b changed the title [MINOR][SQL] Add missing @since tags in functions.expr [MINOR][SQL] Add missing @since tags in functions.scala Jul 29, 2026
@uros-b uros-b changed the title [MINOR][SQL] Add missing @since tags in functions.scala [SPARK-58436][SQL] Add missing @since tags in functions.scala Jul 29, 2026
@zhengruifeng zhengruifeng changed the title [SPARK-58436][SQL] Add missing @since tags in functions.scala [SPARK-58436][SQL][DOC] Add missing @since tags in functions.scala Jul 31, 2026
zhengruifeng pushed a commit that referenced this pull request Jul 31, 2026
### 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 <221401595+uros-b@users.noreply.github.com>
Signed-off-by: Ruifeng Zheng <ruifengz@apache.org>
(cherry picked from commit 256d453)
Signed-off-by: Ruifeng Zheng <ruifengz@apache.org>
@zhengruifeng

Copy link
Copy Markdown
Contributor

Merge Summary:

Posted by merge_spark_pr.py

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants