Documentation updates and first configuration changes:

  - Added @deprecated tags to the old bindings, with test pointing to their replacement.
  - Added a note in the header of the new bindings suggesting to keep the classes synchronized with GeoAPI (if possible).
  - Edited the README file for the new bindings, but did not yet edited the example.
  - Added the new files to the list of files declared in Makefile.in, and ran automake to regenerate Makefile.am.
  - Edited build.xml to generate the header file of PJ.h instead than Projections.h.


git-svn-id: http://svn.osgeo.org/metacrs/proj/trunk@2092 4e78687f-474d-0410-85f9-8d5e500ac6b2

1 files changed, 26 insertions, 20 deletions

diff --git a/jniwrap/org/proj4/ProjectionData.java b/jniwrap/org/proj4/ProjectionData.java
index 95356d09..8ee72772 100644
--- a/jniwrap/org/proj4/ProjectionData.java
+++ b/jniwrap/org/proj4/ProjectionData.java
@@ -14,33 +14,39 @@
  REVISION:  ---
  =====================================================================================*/
 
-/* 
- This library is free software; you can redistribute it and/or 
- modify it under the terms of the GNU Library General Public 
- License as published by the Free Software Foundation; either 
- version 2 of the License, or (at your option) any later version. 
+/*
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Library General Public
+ License as published by the Free Software Foundation; either
+ version 2 of the License, or (at your option) any later version.
 
- This library is distributed in the hope that it will be useful, 
- but WITHOUT ANY WARRANTY; without even the implied warranty of 
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU 
- Library General Public License for more details. 
+ This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ Library General Public License for more details.
 
- You should have received a copy of the GNU Library General Public 
- License along with this library; if not, write to the Free 
- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
- USA 
+ You should have received a copy of the GNU Library General Public
+ License along with this library; if not, write to the Free
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
+ USA
 
- 1. Redistributions of source code must retain the above copyright   
- notice, this list of conditions and the following disclaimer.   
- 2. Redistributions in binary form must reproduce the above copyright   
- notice, this list of conditions and the following disclaimer in the   
- documentation and/or other materials provided with the distribution.   
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
  */
 package org.proj4;
 
 /**
  * class representing the dataset to be reprojected
+ *
+ * @deprecated The new {@link PJ} class uses a different layout for coordinate values.
+ * The new layout is the same than the one used by {@link java.awt.geom.AffineTransform}
+ * in Java2D: tuples of (<var>x</var>,<var>y</var>,&lt;<var>y</var>&gt;) coordinates in
+ * a single flat array.
  */
+@Deprecated
 public class ProjectionData
 {
 
@@ -52,7 +58,7 @@ public class ProjectionData
   public int rows = 0;
 
   /**
-   * object to hold the data to be transformed. This will be passed from 
+   * object to hold the data to be transformed. This will be passed from
    * the starting projection object to the destinantion projection passing through
    * the transformation.
    */
@@ -61,7 +67,7 @@ public class ProjectionData
     rows = _coord.length;
     x = new double[rows];
     y = new double[rows];
-    
+
     for (int i = 0; i < rows; i++)
     {
       x[i] = _coord[i][0];