RFR: 8337111: Bad HTML checker for generated documentation [v3]

Jonathan Gibbons jjg at openjdk.org
Sat Dec 14 21:13:36 UTC 2024


On Fri, 13 Dec 2024 17:12:56 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:

>> I assumed text would be written in latin characters, but I guess this can be removed and we can simply use UTF8?
>
> Unicode has some characters such as bidi characters which I don't want to allow but this test should only check for bistrot and character encoding, so UTF_8 could work as a default.

Note that JDK source code is inconsistent.   The makefile commands for `javac` specify just ASCII (since forever) but the `javadoc` commands allow ISO-8859-1, which was popular before the widespread acceptance of UTF-8.

Ideally, all should be self-consistent -- JDK policy, `javac` commands, `javadoc` commands, DocCheck, etc.
Note that resource files might use different encodings to `*.java` source files.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21879#discussion_r1885390363


More information about the javadoc-dev mailing list