It would help to divide the properties into two parts:
- one with command line warning/error messages
- the other with text that appears in the generated HTML

Then someone who is only interested in translating the generated HTML
could easily minimize the amount of translation they would need to do.

This could be done either by splitting the properties files into two
files, or, more easily, simply separating the comments in the file,
putting one group ahead of the other, suitably commented.

I know this affects doclets.properties, but might also affect others, such as javadoc.properties.

This is related to request:
5029959: Store and pass in translated doc comments for values() and valueOf() of Enum