RFR: 8267633: Clarify documentation of (Doc)TreeScanner [v2]

[Pavel Rappo]

> 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.

Pavel Rappo has updated the pull request incrementally with one additional commit since the last revision:

  Remove inconsistent whitespace in <li>

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/4174/files
  - new: https://git.openjdk.java.net/jdk/pull/4174/files/9f5ba184..27590231

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=4174&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=4174&range=00-01

  Stats: 2 lines in 2 files changed: 0 ins; 0 del; 2 mod
  Patch: https://git.openjdk.java.net/jdk/pull/4174.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/4174/head:pull/4174

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