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

Wed Feb 10 04:49:38 UTC 2021

On Wed, 10 Feb 2021 04:26:17 GMT, Prasanta Sadhukhan <psadhukhan at openjdk.org> wrote:

>> Looks like this is just a bug in the implementation, the null should reset the clip.
>
> I am not sure if it's implementation bug. As Jim Graham has mentioned in thebug, 
> 
>> clip(null) is not legal.
>> 
>> It is *setClip*(null) that clears the clip.
> I could rephrase the doc to specify NPE willbe thrrown for null Shape if a clip is already set.

If "*setClip*(null)" has to clear the clip then it should be specified, currently, that method said nothing about the null parameter.

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

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