RFR: 8267633: Clarify documentation of (Doc)TreeScanner

[Jonathan Gibbons]

On Mon, 24 May 2021 21:05:02 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> When a method is said to be called "on an object", this means that the object is a receiver. When a method is said to be called "with an object", this means that the object is a parameter.
> 
> To scan an instance of (Doc)Tree, the "scan" method is called on the instance of (Doc)TreeScanner with that instance of (Doc)Tree.

OK.

I'm not entirely comfortable with the phrasing of  `call with` but I understand the issue with `call on`.

src/jdk.compiler/share/classes/com/sun/source/util/TreeScanner.java line 44:

> 42:  * result of calling {@code scan} with that child. The child may be a simple node
> 43:  * or itself a list of nodes.
> 44:  * <li> If the node being visited has more than one child, the result will

Inconsistent space after `<li>`  (Since this is mostly a cleanup PR)

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

Marked as reviewed by jjg (Reviewer).

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