On Wed, 17 Feb 2021 15:38:10 GMT, Prasanta Sadhukhan <psadhuk...@openjdk.org> wrote:
>> 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 one > additional commit since the last revision: > > javadoc change src/java.desktop/share/classes/java/awt/Graphics2D.java line 1207: > 1205: * with the current clip, it will throw {@code NullPointerException} > 1206: * for a null shape unless the user clip is also {@code null}. > 1207: * So calling this method with a null argument is not recommended. This suggestion still applies too. Suggestion: * for a {@code null} shape unless the user clip is also {@code null}. * So calling this method with a {@code null} argument is not recommended. ------------- PR: https://git.openjdk.java.net/jdk/pull/2476