RFR: 8360575: java.util.Properties.list() methods trim each value to 37 characters in the listed output [v3]

[Roger Riggs]

On Fri, 27 Jun 2025 14:45:19 GMT, Jaikiran Pai <jpai at 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.
>
> Jaikiran Pai has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Andy's review suggestions

You'll need a CSR since you're changing spec text.  (output stream -> PrintStream) and the new ImplNote.
It might be worth considering this list() method should be deprecated. 
And/or document as being useful for debugging only.

Consider proposing better replacement.  But that's a bigger (possibly more satisfying task)

-------------

PR Comment: https://git.openjdk.org/jdk/pull/26018#issuecomment-3013459562