-
CSR
-
Resolution: Approved
-
P4
-
None
-
minimal
-
No risk, the description of the BasicTextUI.getVisibleEditorRect method is rephrased and clarified.
-
Java API
-
SE
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() {
- csr of
-
JDK-6955128 Spec for javax.swing.plaf.basic.BasicTextUI.getVisibleEditorRect contains inappropriate wording
-
- Resolved
-