[calcite-site] branch main updated: Website deployed from calcite@687dec0afcfab781f905b16e422bc03bd6b9209e

[as...@apache.org]

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 <bc...@users.noreply.github.com>
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