--- old/src/java.desktop/share/classes/java/awt/image/AbstractMultiResolutionImage.java 2016-08-30 14:41:52.000000000 +0530 +++ new/src/java.desktop/share/classes/java/awt/image/AbstractMultiResolutionImage.java 2016-08-30 14:41:52.000000000 +0530 @@ -64,27 +64,70 @@ public abstract class AbstractMultiResolutionImage extends java.awt.Image implements MultiResolutionImage { + /** + * This method simply delegates to the {@code getBaseImage()} and + * it is equivalent to: {@code getBaseImage().getWidth(observer)}. + * + * @return + * @see #getBaseImage() + * + * @since 9 + */ @Override public int getWidth(ImageObserver observer) { return getBaseImage().getWidth(observer); } + /** + * This method simply delegates to the {@code getBaseImage()} and + * it is equivalent to: {@code getBaseImage().getHeight(observer)}. + * + * @return + * @see #getBaseImage() + * + * @since 9 + */ @Override public int getHeight(ImageObserver observer) { return getBaseImage().getHeight(observer); } + /** + * This method simply delegates to the {@code getBaseImage()} and + * it is equivalent to: {@code getBaseImage().getSource()}. + * + * @return + * @see #getBaseImage() + * + * @since 9 + */ @Override public ImageProducer getSource() { return getBaseImage().getSource(); } + /** + * This method is not supported by {@code AbstractMultiResolutionImage} and + * always throws {@code UnsupportedOperationException} + * + * @return {@code UnsupportedOperationException} is thrown + * @throws UnsupportedOperationException this method is not supported + */ @Override public Graphics getGraphics() { throw new UnsupportedOperationException("getGraphics() not supported" + " on Multi-Resolution Images"); } + /** + * This method simply delegates to the {@code getBaseImage()} and + * it is equivalent to: {@code getBaseImage().getProperty(name, observer)}. + * + * @return + * @see #getBaseImage() + * + * @since 9 + */ @Override public Object getProperty(String name, ImageObserver observer) { return getBaseImage().getProperty(name, observer);