RFR: JDK-8253733: Cleanup internal taglet API

[Jonathan Gibbons]

On Wed, 30 Sep 2020 11:16:31 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> This is a general cleanup of various classes related to the handling of tags and taglets in the standard doclet.
>> 
>> The initial motivation was to clean up static methods on `TagletWriter` that took a `TagletWriter` as a parameter.
>> These methods are converted into instance methods, and the call sites simplified as well.
>> Another area of cleanup is to make clear which methods are used for inline tags and which are used for block tags.
>> 
>> Some dead code is removed, and the doc comments are generally cleaned up as well.  More details are given in the JBS
>> issue.
>
> Changes requested by prappo (Reviewer).

@pavelrappo , thanks for the list of files that need copyright updates; I've not yet figured out how to update the
scripts that I used to use to update files, and I used to do it after review and before push, to minimize noise in the
review. Old habits die hard.

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

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