<Swing Dev> description for JSplitPanUI.finishedPaintingChildren()

[Alexander Scherbatiy]

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