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