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

Reply via email to