RFR: 8268978: Document the javadoc software stack

Mon Jan 24 20:48:11 UTC 2022

On Mon, 24 Jan 2022 20:22:12 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

>> I think it helps to keep them separate ... and the text is adjacent.
>> 
>> "Other Doclets" is somewhat more about why you might not want to write a doclet these days ... it's addressing the historical past where there were lots of doclets, a lot of which did not even look at doc comments ... i.e they were using the Doclet API as an early Language Model API.
>
> Fine with me. Your explanation makes sense, another bit of history learned.

I'd forgotten, until now, there is a more detailed version of this text on the OpenJDK website.  I'll leave all the text here, but add an `@see`

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

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