small comment improvements in Point.java

git-svn-id: http://svn.osgeo.org/postgis/trunk@2042 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/jdbc2/src/org/postgis/Point.java b/jdbc2/src/org/postgis/Point.java
index 49a7ce31885bce20f7806a6f8303ef7a198de5e1..bb8e87f07aa67aa98cc2acb0a9fa97ad0e72c42d 100644 (file)
--- a/jdbc2/src/org/postgis/Point.java
+++ b/jdbc2/src/org/postgis/Point.java
@@ -83,16 +83,21 @@ public class Point extends Geometry {
 
     /**
      * The X coordinate of the point.
+     * In most long/lat systems, this is the longitude.
      */
     public double x;
 
     /**
      * The Y coordinate of the point.
+     * In most long/lat systems, this is the latitude.
      */
     public double y;
 
     /**
      * The Z coordinate of the point.
+     * In most long/lat systems, this is a radius from the 
+     * center of the earth, or the height / elevation over
+     * the ground.
      */
     public double z;
 
@@ -105,6 +110,11 @@ public class Point extends Geometry {
         super(POINT);
     }
 
+    /** Constructs a new Point
+     * @param x the longitude / x ordinate
+     * @param y the latitude / y ordinate
+     * @param z the radius / height / elevation / z ordinate
+     */
     public Point(double x, double y, double z) {
         this();
         this.x = x;
@@ -113,6 +123,10 @@ public class Point extends Geometry {
         dimension = 3;
     }
 
+    /** Constructs a new Point
+     * @param x the longitude / x ordinate
+     * @param y the latitude / y ordinate
+     */
     public Point(double x, double y) {
         this();
         this.x = x;