Hello all
I just added an experimental EPSG annotation [1] for documentation
purpose only. This annotation serves no programmatic purpose. The intend
is to take trace of SIS elements (class, methods, fields) that map to an
element from the EPSG database. For example [2] is basically computing
the matrix to use for performing the "Position Vector transformation in
geocentric domain" (EPSG:1033) operation, so it would have an
"@EPSG(type = OperationMethod.class, code = 1033)" annotation telling that.
However, we were usually telling the same thing as plain text in the
javadoc. So is this "@EPSG" annotation just noise not worth its weight?
The original intend was to make search operations easier since the IDE
refactoring tools can be used. However the EPSG database is very stable,
so it may not be necessary. Given that the javadoc tools produced more
verbose output than an though, I wonder.
On a related question, the EPSG database would be of great importance to
SIS. However I'm not sure if the Term of Uses [3] are acceptable to
Apache? The data may be used, copied and distributed subject to some
conditions, in particular:
* The data may be included in any commercial package provided that any
commerciality is based on value added by the provider and not on a
value ascribed to the EPSG Dataset which is made available at no charge.
* Ownership of the EPSG Dataset by OGP must be acknowledged in any
publication or transmission (by whatever means) thereof (including
permitted modifications).
Would it be compatible with Apache?
Martin
[1]
https://builds.apache.org/job/sis-jdk7/site/apidocs/org/apache/sis/referencing/EPSG.html
[2]
https://builds.apache.org/job/sis-jdk7/site/apidocs/org/apache/sis/referencing/datum/BursaWolfParameters.html#getPositionVectorTransformation%28%29
[3] http://www.epsg-registry.org/help/xml/Terms_Of_Use.html
