This is an automated email from the ASF dual-hosted git repository.
asf-ci-deploy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/calcite-site.git
The following commit(s) were added to refs/heads/main by this push:
new 15071783 Website deployed from
calcite@687dec0afcfab781f905b16e422bc03bd6b9209e
15071783 is described below
commit 150717830d7afd9f77fd0330c15069b028bc4f71
Author: bchapuis <[email protected]>
AuthorDate: Thu Dec 1 13:56:52 2022 +0000
Website deployed from calcite@687dec0afcfab781f905b16e422bc03bd6b9209e
---
docs/howto.html | 2 ++
docs/reference.html | 7 +++++++
docs/spatial.html | 10 ++++++++++
3 files changed, 19 insertions(+)
diff --git a/docs/howto.html b/docs/howto.html
index f0fc1d05..0b6f7b53 100644
--- a/docs/howto.html
+++ b/docs/howto.html
@@ -993,6 +993,8 @@ that the <code class="language-plaintext
highlighter-rouge">META-INF</code> dire
</li>
<li>Check PGP, per <a
href="https://httpd.apache.org/dev/verification.html";>this</a>
</li>
+ <li>Check that Proj4J is not among the api and implementation dependencies,
+as the EPSG database is not redistributable.</li>
</ul>
<p>Verify the staged artifacts in the Nexus repository:</p>
diff --git a/docs/reference.html b/docs/reference.html
index 09f0f127..b4e2ce8a 100644
--- a/docs/reference.html
+++ b/docs/reference.html
@@ -4750,6 +4750,13 @@ implements the OpenGIS Simple Features Implementation
Specification for SQL,
<h4 id="geometry-projection-functions">Geometry projection functions</h4>
+<p>Projection functions rely on Proj4J to transform the geometries.
+Proj4J is released under the Apache License 2.0, however, it also uses the
EPSG dataset,
+which has restricting <a href="https://epsg.org/terms-of-use.html";>terms of
use</a>.
+As a result, Proj4J is not suitable for inclusion in Apache Calcite
+and some of these functions may throw <code class="language-plaintext
highlighter-rouge">ClassNotFoundException</code>s.
+Users can still use these functions by including Proj4J in their classpath.</p>
+
<div class="scroll-table-style"><table>
<thead>
<tr>
diff --git a/docs/spatial.html b/docs/spatial.html
index a5f673a7..27e9765a 100644
--- a/docs/spatial.html
+++ b/docs/spatial.html
@@ -93,6 +93,7 @@ and other forms of query optimization.</p>
<li><a href="#introduction"
id="markdown-toc-introduction">Introduction</a></li>
<li><a href="#enabling-spatial-support"
id="markdown-toc-enabling-spatial-support">Enabling spatial support</a></li>
<li><a href="#query-rewrites" id="markdown-toc-query-rewrites">Query
rewrites</a></li>
+ <li><a href="#limitations" id="markdown-toc-limitations">Limitations</a></li>
<li><a href="#acknowledgements"
id="markdown-toc-acknowledgements">Acknowledgements</a></li>
</ul>
@@ -228,6 +229,15 @@ These rewrites are worth performing because they are much
quicker to apply,
and often allow range scans on the Hilbert index.
But for safety, Calcite applies the original predicate, to remove false
positives.</p>
+<h2 id="limitations">Limitations</h2>
+
+<p>Some spatial functions rely on Proj4J to transform the projection of
spatial objects.
+Proj4J is released under the Apache License 2.0, however, it also uses the
EPSG dataset,
+which has restricting <a href="https://epsg.org/terms-of-use.html";>terms of
use</a>.
+As a result, Proj4J is not suitable for inclusion in Apache Calcite
+and these functions will throw <code class="language-plaintext
highlighter-rouge">ClassNotFoundException</code>s.
+Users can still use these functions by including Proj4J in their classpath.</p>
+
<h2 id="acknowledgements">Acknowledgements</h2>
<p>Calcite’s OpenGIS implementation uses the
