[OpenJDK 2D-Dev] RFR: 6206189: Graphics2D.clip specifies incorrectly that a 'null' is a valid value for this method [v2]

[Prasanta Sadhukhan]

> The API doc for Graphics2D.clip(shape s) claims that passing a null argument would actually clear the existing clipping area, which is incorrect.
> This statement is applicable only to G2D.setClip() and not for the clip() method. G2D.clip() would throw a NullPointerException when it encounters a null argument. 
> Updated spec to rectify this.

Prasanta Sadhukhan has updated the pull request incrementally with three additional commits since the last revision:

 - Fix
 - Document setClip(null) behaviour too
 - Document setClip(null) behaviour too

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/2476/files
  - new: https://git.openjdk.java.net/jdk/pull/2476/files/a7798fb5..94a04228

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

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

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