On Fri, 2 Dec 2022 16:36:22 GMT, Magnus Ihse Bursie <i...@openjdk.org> wrote:

> According to [the 
> specification](https://docs.oracle.com/en/java/javase/19/docs/api/java.base/java/util/Properties.html#load(java.io.Reader))
>  trailing whitespaces in the values of properties files are (somewhat 
> surprisingly) actually significant.
> 
> We have multiple files in the JDK with trailing whitespaces in the values. 
> For most of this files, this is likely incorrect and due to oversight, but in 
> a few cases it might actually be intended (like "The value is: ").
> 
> After a discussion in the PR for 
> [JDK-8295729](https://bugs.openjdk.org/browse/JDK-8295729), the consensus was 
> to replace valid trailing spaces with the corresponding unicode sequence, 
> `\u0020`. (And of course remove non-wanted trailing spaces.)
> 
> Doing so has a dual benefit:
> 
> 1) It makes it clear to everyone reading the code that there is a trailing 
> space and it is intended
> 
> 2) It will allow us to remove all actual trailing space characters, and turn 
> on the corresponding check in jcheck to keep the properties files, just like 
> all other source code files, free of trailing spaces.
> 
> Ultimately, the call of whether a trailing space is supposed to be there, or 
> is a bug, lies with the respective component teams owning these files. Thus I 
> have split up the set of properties files with trailing spaces in several 
> groups, to match the JDK teams, and open a JBS issue for each of them. This 
> issue is for code I believe belongs with the langtools team.

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/resources/standard_ja.properties
 line 142:

> 140: 
> doclet.Implementing_Classes=\u65E2\u77E5\u306E\u5B9F\u88C5\u30AF\u30E9\u30B9\u306E\u30EA\u30B9\u30C8:
> 141: 
> doclet.Functional_Interface=\u6A5F\u80FD\u30A4\u30F3\u30BF\u30D5\u30A7\u30FC\u30B9
> 142: 
> doclet.Functional_Interface_Message=\u3053\u308C\u306F\u6A5F\u80FD\u30A4\u30F3\u30BF\u30D5\u30A7\u30FC\u30B9\u306A\u306E\u3067\u3001\u30E9\u30E0\u30C0\u5F0F\u307E\u305F\u306F\u30E1\u30BD\u30C3\u30C9\u53C2\u7167\u306E\u5272\u5F53\u3066\u30BF\u30FC\u30B2\u30C3\u30C8\u3068\u3057\u3066\u4F7F\u7528\u3067\u304D\u307E\u3059\u3002\u0020

standard.properties (en, de, zh) does not have a trailing white space for 
doclet.Functional_Interface_Message.

For consistency, there should not be a space here.

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

PR: https://git.openjdk.org/jdk/pull/11487

Reply via email to