RFR: 8266666: Implementation for snippets [v5]

[Pavel Rappo]

On Fri, 23 Jul 2021 20:13:56 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> the existing seeTagToContent handles all flavors of @see tag, and {@link}.

All but fake ones. The `seeTagToContent` method uses the path (`DocTreePath`) of the `see` tag being passed. In the case of snippet markup, there's no such tag; so there's noting to derive the path from. Even if we synthesized such a tag, we would need to carefully embed it into the doc comment tree for the duration of the call to `seeTagToContent`, which is way too complicated and might have unforeseen effects.

I would appreciate it, if you could help me refactor this code.

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

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