On Mon, 30 Jun 2025 06:01:44 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 - no need to state the number of characters The example could get complicated; depending on what output is desired. The existence of a separate "default" Properties object adds complexity. For simplicity, I'd print the direct map elements and then recursively print the default Propertys. No flattening of the property names and no sorting. Keep the example simple, leave the embellishments to whoever copies the example. Don't try to exactly reproduce the existing method. ------------- PR Comment: https://git.openjdk.org/jdk/pull/26018#issuecomment-3075791482