sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1688999 - /sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/io/wkt/WKTFormat.java
Date Fri, 03 Jul 2015 11:08:01 GMT
Author: desruisseaux
Date: Fri Jul  3 11:08:01 2015
New Revision: 1688999

URL: http://svn.apache.org/r1688999
Log:
Add a warning about the fact that the WKT format is not lossless.

Modified:
    sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/io/wkt/WKTFormat.java

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/io/wkt/WKTFormat.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/io/wkt/WKTFormat.java?rev=1688999&r1=1688998&r2=1688999&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/io/wkt/WKTFormat.java
[UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/io/wkt/WKTFormat.java
[UTF-8] Fri Jul  3 11:08:01 2015
@@ -79,6 +79,11 @@ import org.apache.sis.internal.util.Stan
  *
  * <div class="section">Limitations</div>
  * <ul>
+ *   <li><strong>The WKT format is not lossless!</strong>
+ *       Objects formatted by {@code WKTFormat} are not guaranteed to be identical after
parsing.
+ *       Some metadata may be lost or altered, but the coordinate operations between two
CRS should produce
+ *       the same numerical results provided that the two CRS were formatted independently
(do not rely on
+ *       {@link org.opengis.referencing.crs.GeneralDerivedCRS#getConversionFromBase()} for
instance).</li>
  *   <li>Instances of this class are not synchronized for multi-threading.
  *       It is recommended to create separated format instances for each thread.
  *       If multiple threads access a {@code WKTFormat} concurrently, it must be synchronized
externally.</li>



Mime
View raw message