Integrated: JDK-8289775: Update java.lang.invoke.MethodHandle[s] to use snippets

[John R Rose]

On Tue, 5 Jul 2022 22:22:46 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Update existing examples in  java.lang.invoke.{MethodHandle, MethodHandles} to use snippets rather than the older markup idiom.

The code examples in these files were exdented to make it easier to extract example code and test it, and to maintain equivalence during active development of the APIs.

The examples in runnable form are in test/jdk/java/lang/invoke/JavaDocExamplesTest.java in the same repo.

It would be nice if some day we could tie together the two copies into one using a link.  I don't recall whether snippets can do this or not, given that the two copies are far apart in the repo structure.

I agree that just the bracket changes are valuable by themselves.  I also have no objection to fixing the exdentation.

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

Marked as reviewed by jrose (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/9385#pullrequestreview-1030687047