Name: mgC56079 Date: 01/22/99



These are the javadoc comments for contains(Point), contains(int, int) and
contains(double, double).
They are all different and incomplete.
The algorithm was changed in JDK1.2.2-C (probably a bug fix for 4096608)
which caused a JCK1.2a regression:
  api/java_awt/Polygon/descriptions.html#inside11

The JCK test cannot be updated until the complete specification is provided.


    /**
     * Determines whether the specified {@link Point} is inside this
     * <code>Polygon</code>. Uses an even-odd insideness rule (also known
     * as an alternating rule).
     * @param p the specified <code>Point</code> to be tested
     * @return <code>true</code> if the <code>Polygon</code> contains the
     * <code>Point</code>; <code>false</code> otherwise.
     */
    public boolean contains(Point p)

    /**
     * Determines whether the specified coordinates are contained in this
     * <code>Polygon</code>.
     * <p>
     * (The <code>contains</code> method is based on code by
     * Hanpeter van Vliet [###@###.###.)
     * @param x,&nbsp;y the specified coordinates to be tested
     * @return <code>true</code> if this <code>Polygon</code> contains
     * the specified coordinates, (<i>x</i>,&nbsp;<i>y</i>);
     * <code>false</code> otherwise.
     * @since JDK1.1
     */
    public boolean contains(int x, int y)

    /**
     * Tests if the specified coordinates are inside the boundary of the
     * <code>Shape</code>.
     * @param x,&nbsp;y the specified coordinates
     * @return <code>true</code> if the <code>Shape</code> contains the
     * specified coordinates; <code>false</code> otherwise.
     */
    public boolean contains(double x, double y)


======================================================================