On Fri, 27 Jun 2025 13:20:35 GMT, Jaikiran Pai <j...@openjdk.org> wrote:
> Can I please get a review of this doc-only change which proposes to clarify > the current implementation of the `java.util.Properties.list(...)` methods? > > As noted in https://bugs.openjdk.org/browse/JDK-8360575, the current > implementation trims each value to a size of 37 when printing out the value. > This behaviour isn't documented by these methods. The change in this PR adds > an `@implNote` to make a mention of this current behaviour. Are you sure you want to describe the format, even in an implNote? Although the string representation probably hasn't changed in 25+ years, it's not something that anything should become dependent on. Updating the method description to include an example of how to print out the properties and their values might be more useful. We also need to think about whether to just deprecate this method (ThreadGroup.list too). ------------- PR Comment: https://git.openjdk.org/jdk/pull/26018#issuecomment-3013132287