On Fri, 27 Jun 2025 14:03:59 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.
>
> 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

Reply via email to