On 5/30/2014 8:54 PM, Steve Sides wrote:
While adding @param and @return tags to appease doclint, I came across
javax.swing.plaf.SplitPanUI.finishedPaintingChildren(). I find the
description of this method a little baffling. It's either missing some
words or punctuation, or is just simply stated in a confusing manner.
Can you offer some explanation for what this method does and maybe
suggest a better wording for the description?
*
finishedPaintingChildren
public abstract void finishedPaintingChildren(JSplitPane
<http://sqeweb.us.oracle.com/coretools/comptools/users/ssides/jdk9_dev/docs/doc/javax/swing/JSplitPane.html>
jc,
Graphics
<http://sqeweb.us.oracle.com/coretools/comptools/users/ssides/jdk9_dev/docs/doc/java/awt/Graphics.html>
g)
Messaged after the JSplitPane the receiver is providing the look
and feel for paints its children.
It sounds strange for me too. I think it is better to use the
description from the BasicSplitPaneUI.finishedPaintingChildren() method:
- Called when the specified split pane has finished painting
its children.
http://docs.oracle.com/javase/7/docs/api/javax/swing/plaf/basic/BasicSplitPaneUI.html#finishedPaintingChildren%28javax.swing.JSplitPane,%20java.awt.Graphics%29
However, changing the current description in the SplitPaneUI
requires creating the CCC request.
Thanks,
Alexandr.
*
-steve
