szehon-ho opened a new pull request, #55958: URL: https://github.com/apache/spark/pull/55958
### What changes were proposed in this pull request? Clarify scaladoc for `PushDownUtils.pushRuntimeFilters` and `PushDownUtils.replanWithRuntimeFilters` introduced in [SPARK-56868](https://issues.apache.org/jira/browse/SPARK-56868) ([#55887](https://github.com/apache/spark/pull/55887)): - Document the mutating-scan constraint on `pushRuntimeFilters`, where `SupportsRuntimeV2Filtering.filter` is invoked. - Replace the mixed Note/Precondition text on `replanWithRuntimeFilters` with a concise Notes bullet list. ### Why are the changes needed? The original helper scaladoc mixed concerns (execute-time requirements, caller caching, and preconditions) and referenced `pushRuntimeFilters` from the wrong method. This follow-up makes the documentation easier to read without changing behavior. ### Does this PR introduce _any_ user-facing change? No. ### How was this patch tested? Documentation-only change; existing tests cover runtime filter behavior. ### Was this patch authored or co-authored using generative AI tooling? No. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
