Summary

Remove irrelevant, non-normative text from the specification of javax.swing.plaf.basic.BasicTextUI.getVisibleEditorRect()

Problem

The specification for javax.swing.plaf.basic.BasicTextUI.getVisibleEditorRect() contains the following text:

… Due to an unfortunate set of historical events this method is inappropriately named. The Rectangle returned has nothing to do with visibility.

The current wording is informal, it should be revised.

Solution

Clarify the purpose of the method, follow neutral and technical style.

Specification

javax.swing.plaf.basic.BasicTextUI

     /**
-     * Gets the allocation to give the root View.  Due
-     * to an unfortunate set of historical events this
-     * method is inappropriately named.  The Rectangle
-     * returned has nothing to do with visibility.
+     * Gets the allocation (that is the allocated size) for the root view.
+     * <p>
+     * The returned rectangle is unrelated to visibility.
+     * It is used to set the size of the root view.
+     * <p>
      * The component must have a non-zero positive size for
      * this translation to be computed.
      *
      * @return the bounding box for the root view
+     * @see View#paint
+     * @see View#setSize
      */
     protected Rectangle getVisibleEditorRect() {