--- old/src/java.desktop/share/classes/java/awt/Component.java 2015-09-23 20:50:34.000000000 +0300 +++ new/src/java.desktop/share/classes/java/awt/Component.java 2015-09-23 20:50:34.000000000 +0300 @@ -3628,18 +3628,17 @@ } /** - * Creates an off-screen drawable image - * to be used for double buffering. - * @param width the specified width - * @param height the specified height - * @return an off-screen drawable image, which can be used for double - * buffering. The return value may be null if the - * component is not displayable. This will always happen if - * GraphicsEnvironment.isHeadless() returns - * true. + * Creates an off-screen drawable image to be used for double buffering. + * + * @param width the specified width + * @param height the specified height + * @return an off-screen drawable image, which can be used for double + * buffering. The {@code null} value if the component is not + * displayable or {@code GraphicsEnvironment.isHeadless()} returns + * {@code true}. * @see #isDisplayable * @see GraphicsEnvironment#isHeadless - * @since 1.0 + * @since 1.0 */ public Image createImage(int width, int height) { ComponentPeer peer = this.peer; @@ -3652,19 +3651,19 @@ } /** - * Creates a volatile off-screen drawable image - * to be used for double buffering. - * @param width the specified width. - * @param height the specified height. - * @return an off-screen drawable image, which can be used for double - * buffering. The return value may be null if the - * component is not displayable. This will always happen if - * GraphicsEnvironment.isHeadless() returns - * true. + * Creates a volatile off-screen drawable image to be used for double + * buffering. + * + * @param width the specified width + * @param height the specified height + * @return an off-screen drawable image, which can be used for double + * buffering. The {@code null} value if the component is not + * displayable or {@code GraphicsEnvironment.isHeadless()} returns + * {@code true}. * @see java.awt.image.VolatileImage * @see #isDisplayable * @see GraphicsEnvironment#isHeadless - * @since 1.4 + * @since 1.4 */ public VolatileImage createVolatileImage(int width, int height) { ComponentPeer peer = this.peer; @@ -3680,22 +3679,26 @@ } /** - * Creates a volatile off-screen drawable image, with the given capabilities. - * The contents of this image may be lost at any time due - * to operating system issues, so the image must be managed - * via the VolatileImage interface. - * @param width the specified width. - * @param height the specified height. - * @param caps the image capabilities - * @exception AWTException if an image with the specified capabilities cannot - * be created - * @return a VolatileImage object, which can be used - * to manage surface contents loss and capabilities. + * Creates a volatile off-screen drawable image, with the given + * capabilities. The contents of this image may be lost at any time due to + * operating system issues, so the image must be managed via the + * {@code VolatileImage} interface. + * + * @param width the specified width + * @param height the specified height + * @param caps the image capabilities + * @return a VolatileImage object, which can be used to manage surface + * contents loss and capabilities. The {@code null} value if the + * component is not displayable or + * {@code GraphicsEnvironment.isHeadless()} returns {@code true}. + * @throws AWTException if an image with the specified capabilities cannot + * be created * @see java.awt.image.VolatileImage * @since 1.4 */ public VolatileImage createVolatileImage(int width, int height, - ImageCapabilities caps) throws AWTException { + ImageCapabilities caps) + throws AWTException { // REMIND : check caps return createVolatileImage(width, height); }