RFR: JDK-8269401: Merge "Exceptions" and "Errors" into "Exception Classes" [v2]

Jonathan Gibbons jjg at openjdk.java.net
Tue Oct 26 14:34:15 UTC 2021


On Tue, 26 Oct 2021 12:57:22 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> Separately, I have *long* wanted a general clean up on resource naming, replacing the pervasive boring ubiquitous less-than-helpful `doclet.` prefix with something more informative. I would like to see a prefix that indicates the resource file (e.g. `tool` | `toolkit` | `html` ) and the category/kind (such as `warning`, `error`, `help`, `content`)
>> 
>> Maybe this is something to do in the next release (19). The first steps are to decide on a naming policy and to write an internal utility that will modify source code and resource files.   Strongly related in such a utility would be the sort the contents of the resource files.
>
>> There's old naming and new naming. We still use old naming for older releases, and use the new naming for recent releases. There's low-level code to select the right form, depending on the version.
> 
> Interesting; could you point me in the direction of this low-level code?

Start with `HtmlDoclet.getResourceKeyMapper` (starting at about line 131), and follow the code down to `Resources.setKeyMapper` (line 64) and then `Resources.getText` (line 82) for the use of the mapper.

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

PR: https://git.openjdk.java.net/jdk/pull/6061


More information about the javadoc-dev mailing list