Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-1266429

doc: awt.Polygon needs more specific description

XMLWordPrintable

    • 1.1.4
    • sparc
    • solaris_2.5.1
    • Verified

      The description in the api spec for class Polygon, states each successive pair of coordinates
      defines a side of the polygon.

      Does the last pair of coordinates form a side with the first pair to form the final side OR should the last set of coordinates equal the first so that a side is created?
      This needs to be specified.


      Also, what is a polygon? The description uses the word twice in the description but doesn't specify
      the differences between this usage of the word and the formal definition. Webster defines
      it as a flat, closed geometric figure bounded by 3 or more straight lines. This is not completely
      correct in the api context since one can create a polygon with no points or even modify it so it has
      2 points and still call it a polygon. Are all of the methods guaranteed to work on an awt.Polygon with less than 3 points? These questions should be answered in the documentation.

            asommere Alan Sommerer (Inactive)
            duke J. Duke
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: