JDK-6206189 : DOC: Graphics2D.clip specifies incorrectly that a 'null' is a valid value for this method
  • Type: Bug
  • Component: client-libs
  • Sub-Component: 2d
  • Affected Version: 1.3.0
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • OS: generic
  • CPU: generic
  • Submitted: 2004-12-09
  • Updated: 2012-01-16
Description
The API doc for Graphics2D.clip(shape s) claims that passing a null argument would actually clear the existing clipping area. This 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. 

Hence the '@param' of G2D.clip(shape s) must be changed to state that a null argument would throw a NPE. 

This has been there since 1.3.
###@###.### 2004-12-09 04:11:35 GMT