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

[Andy Goryachev]

On Fri, 27 Jun 2025 14:03:59 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:
> 
>   Alan's review - limit the details in implNote

src/java.base/share/classes/java/util/Properties.java line 1221:

> 1219:      * followed by 3 dot characters.
> 1220:      * <p>
> 1221:      * An alternative for listing the {@code Properties} to a {@code PrintStream} is:

suggestion:
``
An alternative for listing the {@code Properties} to a {@code PrintStream} without truncation is:

src/java.base/share/classes/java/util/Properties.java line 1229:

> 1227:      * }
> 1228:      *
> 1229:      * @param   out   a PrintStream

suggestion: (here and L1263) "the output PrintStream"

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

PR Review Comment: https://git.openjdk.org/jdk/pull/26018#discussion_r2172181338
PR Review Comment: https://git.openjdk.org/jdk/pull/26018#discussion_r2172177913