[OpenJDK 2D-Dev] RFR: 8178457: Remove link to 2D guide from Line2D javadoc
Phil Race
philip.race at oracle.com
Wed Apr 12 19:42:56 UTC 2017
i.e, this change instead :
--- a/src/java.desktop/share/classes/java/awt/geom/Line2D.java
+++ b/src/java.desktop/share/classes/java/awt/geom/Line2D.java
@@ -31,12 +31,7 @@
/**
* This {@code Line2D} represents a line segment in {@code (x,y)}
- * coordinate space. This class, like all of the Java 2D API, uses a
- * default coordinate system called <i>user space</i> in which the y-axis
- * values increase downward and x-axis values increase to the right. For
- * more information on the user space coordinate system, see the
- * <a href="{@docRoot}/../technotes/guides/2d/spec/j2d-intro.html">
- * Coordinate Systems</a> section of the Java 2D Programmer's Guide.
+ * coordinate space.
* <p>
* This class is only the abstract superclass for all objects that
* store a 2D line segment.
-phil.
On 04/11/2017 03:34 PM, Philip Race wrote:
> The boilerplate for all the other classes would be to completely remove
> the entire sentence being modified. No mention of coordinate system at
> all.
>
> I can do that ... if it is what you meant.
>
> -phil.
>
>
> On 4/11/17, 3:01 PM, Jim Graham wrote:
>> It's silly to include this statement in Line2D when no other geometry
>> class bothers to mention this. It is considered assumed information
>> if you've gotten far enough to be looking at this class. I would
>> prefer to copy boiler plate from one of the other Foo2D geometry
>> classes instead...
>>
>> ...jim
>>
>> On 4/11/17 10:43 AM, Phil Race wrote:
>>> A small javadoc change to link to a different more stable source
>>> of information on the Java 2D coord. system.
>>>
>>> Bug : https://bugs.openjdk.java.net/browse/JDK-8178457
>>>
>>> Patch:
>>> --- a/src/java.desktop/share/classes/java/awt/geom/Line2D.java
>>> +++ b/src/java.desktop/share/classes/java/awt/geom/Line2D.java
>>> @@ -35,8 +35,7 @@
>>> * default coordinate system called <i>user space</i> in which the
>>> y-axis
>>> * values increase downward and x-axis values increase to the
>>> right. For
>>> * more information on the user space coordinate system, see the
>>> - * <a href="{@docRoot}/../technotes/guides/2d/spec/j2d-intro.html">
>>> - * Coordinate Systems</a> section of the Java 2D Programmer's Guide.
>>> + * {@link java.awt.Graphics2D} class documentation.
>>> * <p>
>>> * This class is only the abstract superclass for all objects that
>>> * store a 2D line segment.
>>>
>>> -phil.
More information about the 2d-dev
mailing list