JDK-8044301 : BasicTreeUI: "revisit when Java2D is ready"
  • Type: Sub-task
  • Component: client-libs
  • Sub-Component: javax.swing
  • Affected Version: 9
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2014-05-29
  • Updated: 2014-08-29
  • Resolved: 2014-07-17
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 9
9 b26Fixed
Description
Eliminating doclint warnings in jdk/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java, I have to create some (trivial) javadoc for protected methods performing certain painting tasks. They are well commented, for a human (not for doclint), but descriptions start with

"This method is slow -- revisit when Java2D is ready."

Well, it is ready, I guess.

BTW I will not add javadoc to them, and  warnings will not disappear.
Comments
Just wonder why this style of comment is used: It is assumed {@code x1} &lt;= {@code x2}. instead of simple: {@code x1 <= x2}.
17-07-2014
It should be however simple but code change, not javadoc cleanup: please assign it to some Swing developer.
10-06-2014
Well, this (and similar) method below should be removed, and call to it should be changed to some standard three-liner like "...new BasicStroke ... g2d.setStroke...g2d.drawLine". There's no need to write javadoc for that. I don't think there may be a subclass using this prop. And, it's not my business by the way! // This method is slow -- revisit when Java2D is ready. // assumes x1 <= x2 protected void drawDashedHorizontalLine(Graphics g, int y, int x1, int x2){ // Drawing only even coordinates helps join line segments so they // appear as one line. This can be defeated by translating the // Graphics by an odd amount. x1 += (x1 % 2); for (int x = x1; x <= x2; x+=2) { g.drawLine(x, y, x, y); } }
10-06-2014
Why dont you add javadoc, I dont understand
09-06-2014