[MINOR][SQL] Fix incorrect type wording in Row getter scaladoc#57240
[MINOR][SQL] Fix incorrect type wording in Row getter scaladoc#57240LuciferYang wants to merge 1 commit into
Conversation
### What changes were proposed in this pull request? Fixes copy-pasted type wording in the scaladoc of several `Row` getters in the sql-api module. The phrase "value at position i of `<type>` type" was copy-pasted from the date getters onto getters that return other types: - `getGeometry`: "of date type" -> "of geometry type" - `getGeography`: "of date type" -> "of geography type" - `getTimestamp` / `getInstant`: "of date type" -> "of timestamp type" - `getJavaMap`: "of array type" -> "of map type" ### Why are the changes needed? The type wording on these getters was incorrect (copy-pasted from sibling getters), which is misleading in the generated API docs. ### Does this PR introduce _any_ user-facing change? No. Documentation-only; no behavior change. ### How was this patch tested? No tests needed (documentation only). ### Was this patch authored or co-authored using generative AI tooling? Generated-by: Ducc
MaxGekk
left a comment
There was a problem hiding this comment.
LGTM. I verified each reworded getter's Scaladoc now matches its actual return type (getGeometry→geometry, getGeography→geography, getTimestamp/getInstant→timestamp, getJavaMap→map) and lines up with the sibling getters' convention (getDate/getLocalDate=date, getSeq/getList=array, getMap=map, getStruct=struct).
I also checked for anything similar left to fix: grepping the rest of Row.scala shows no other "of <wrong> type" mismatch remains, and the pattern doesn't appear in any other hand-written source file (the only other occurrences are in the generated sql/api/target/java/.../Row.java, which regenerates from this source). So the fix is complete.
dongjoon-hyun
left a comment
There was a problem hiding this comment.
BTW, we had better get a JIRA ID because we need to backport this, @LuciferYang .
uros-b
left a comment
There was a problem hiding this comment.
Thank you for the fix @LuciferYang!
### What changes were proposed in this pull request? Fixes copy-pasted type wording in the scaladoc of several `Row` getters in the sql-api module. The phrase "value at position i of `<type>` type" had been copy-pasted from the date getters onto getters that return other types: - `getGeometry`: "of date type" -> "of geometry type" - `getGeography`: "of date type" -> "of geography type" - `getTimestamp` / `getInstant`: "of date type" -> "of timestamp type" - `getJavaMap`: "of array type" -> "of map type" ### Why are the changes needed? The type wording on these getters was incorrect (copy-pasted from sibling getters), which is misleading in the generated API docs. ### Does this PR introduce _any_ user-facing change? No. Documentation-only; no behavior change. ### How was this patch tested? No tests needed (documentation only). ### Was this patch authored or co-authored using generative AI tooling? Generated-by: Claude Code(Opus 4.8) Closes #57240 from LuciferYang/SPARK-tier3-scaladoc-cleanup. Authored-by: YangJie <yangjie01@baidu.com> Signed-off-by: yangjie01 <yangjie01@baidu.com> (cherry picked from commit 2abe31b) Signed-off-by: yangjie01 <yangjie01@baidu.com>
What changes were proposed in this pull request?
Fixes copy-pasted type wording in the scaladoc of several
Rowgetters in the sql-api module. The phrase "value at position i of<type>type" had been copy-pasted from the date getters onto getters that return other types:getGeometry: "of date type" -> "of geometry type"getGeography: "of date type" -> "of geography type"getTimestamp/getInstant: "of date type" -> "of timestamp type"getJavaMap: "of array type" -> "of map type"Why are the changes needed?
The type wording on these getters was incorrect (copy-pasted from sibling getters), which is misleading in the generated API docs.
Does this PR introduce any user-facing change?
No. Documentation-only; no behavior change.
How was this patch tested?
No tests needed (documentation only).
Was this patch authored or co-authored using generative AI tooling?
Generated-by: Claude Code(Opus 4.8)