RFR: JDK-8275788: Create code element with suitable attributes for code snippets [v3]

[Jonathan Gibbons]

On Fri, 29 Oct 2021 15:16:57 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> > `Utils.toLowerCase` is the right way.
> 
> Some parts of jdk.javadoc reach to jdk.compiler for StringUtils.toLowerCase(String). Smells like cleanup.

Yes. javadoc is complicated.

Architecturally, the "tool" part of `javadoc` inherently has direct access to `javac` and its internals, and structurally, does not have access to `Utils`.  Conversely, the "doclets" world does not (should not) need to access `javac` internals, and so should use `Utils` instead.

In a different world, with smaller modules, the tool would be in one module, and the doclets world would be in one or more different modules.

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

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