This is an automated email from the ASF dual-hosted git repository.
desruisseaux pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/sis-site.git
The following commit(s) were added to refs/heads/main by this push:
new 1a23a244 Update the list CRS and operation methods supported by Apache
SIS 1.4. Update the release management guide following Gradle and
modularisation.
1a23a244 is described below
commit 1a23a2442fb2c9be032a9deaae4f114bf4b5067f
Author: Martin Desruisseaux <[email protected]>
AuthorDate: Sun Oct 1 22:35:43 2023 +0200
Update the list CRS and operation methods supported by Apache SIS 1.4.
Update the release management guide following Gradle and modularisation.
---
content/release-management.md | 56 ++++++++++++++++++++-------
static/tables/CoordinateOperationMethods.html | 14 +++++--
static/tables/CoordinateReferenceSystems.html | 2 +-
3 files changed, 52 insertions(+), 20 deletions(-)
diff --git a/content/release-management.md b/content/release-management.md
index 48935bf0..84c3b81e 100644
--- a/content/release-management.md
+++ b/content/release-management.md
@@ -179,14 +179,15 @@ export SIGNING_KEY=<your key ID> # hexadecimal number
with 8 or 40 digits.
Make sure that the code signing key is the defauly key declared in
`~/.gnupg/gpg.conf`
during the Maven deployment phase.
+
# Review project status before branching {#prepare-source}
Replace the `$OLD_VERSION` number by `$NEW_VERSION` in the values of following
properties on the development branch:
-* `DOWNLOAD_URL` in
`core/sis-utility/src/main/java/org/apache/sis/setup/OptionalInstallations.java`
file.
-* `<sis.non-free.version>` in root `pom.xml` file.
-* Review the `README` and `NOTICE` files in root directory.
-* Review the `README` files in `application/sis-javafx/src/main/artifact/` and
subdirectories.
+* `DOWNLOAD_URL` in
`endorsed/src/org.apache.sis.util/main/org/apache/sis/setup/OptionalInstallations.java`
file
+ (note that the version number appears twice, and once more in `@since`
Javadoc tag).
+* Review the `README.md` and `NOTICE` files in root directory.
+* Review the `README` file in `optional/src/org.apache.sis.gui/bundle/`.
Commit and merge with other branches up to master.
@@ -228,17 +229,42 @@ the
[CoordinateOperationMethods](./tables/CoordinateOperationMethods.html)
and [CoordinateReferenceSystems](./tables/CoordinateReferenceSystems.html)
pages.
Those steps are also useful as additional tests, since failure to generate
those pages may reveal problems.
-1. Open the `AuthorityCodes` class, search `DEPRECATED=0` (it appears in a SQL
fragment) and replace by `(DEPRECATED=0 OR TRUE)`.
- **Do not commit!** This is a temporary hack for including deprecated codes
in the CRS list to be generated.
- Those codes will appear with strike for making clear that they are
deprecated.
-2. Open the `CoordinateOperationMethods` Java class and execute its `main`
method, for example in an IDE.
-3. Open the `CoordinateReferenceSystems` Java class and execute its `main`
method.
-4. If successful, HTML files will be generated in the current directory.
- Open those files in a web browser and verify that information are okay,
- in particular the SIS and EPSG version numbers in the first paragraph.
-5. If okay, move those two HTML files to the `../site/main/static/tables/`
directory, overwriting previous files.
-6. Revert the hack in `AuthorityCodes` class.
-7. Commit: `git commit --message="Update the list CRS and operation methods
supported by Apache SIS $NEW_VERSION."`
+* Open the `AuthorityCodes` class and apply the following changes **withoug
committing them.**
+ They are temporary hacks for including deprecated codes in the CRS list to
be generated.
+ (those codes will appear with strike for making clear that they are
deprecated):
+
+ * Search `DEPRECATED=0` (it appears in a SQL fragment) and replace by
`(DEPRECATED=0 OR TRUE)`.
+ * Comment-out the `if (table.showColumn != null)` block which appears just
above the `DEPRECATED=0` occurrence.
+ <br><br>
+
+* Run the following commands:
+
+ {{< highlight bash >}}
+ gradle assemble
+
+ java --module-path endorsed/build/libs \
+ --limit-modules org.apache.sis.referencing \
+ --patch-module
org.apache.sis.referencing=endorsed/build/classes/java/test/org.apache.sis.referencing
\
+ --module
org.apache.sis.referencing/org.apache.sis.referencing.report.CoordinateOperationMethods
+
+ # Following requires a build of NetBeans project for fetching test
dependencies. This may change in a future version.
+ java --module-path endorsed/build/libs:netbeans-project/build/dependencies \
+ --add-modules
org.opengis.geoapi.conformance,org.apache.derby.tools,org.apache.derby.engine \
+ --limit-modules
org.opengis.geoapi.conformance,org.apache.derby.tools,org.apache.derby.engine,org.apache.sis.referencing
\
+ --add-reads
org.apache.sis.referencing=org.opengis.geoapi.conformance,junit \
+ --patch-module
org.apache.sis.referencing=endorsed/build/classes/java/test/org.apache.sis.referencing
\
+ --module
org.apache.sis.referencing/org.apache.sis.referencing.report.CoordinateReferenceSystems
+ {{< / highlight >}}
+
+* If successful, HTML files will be generated in the current directory.
+ Open those files in a web browser and verify that information are okay,
+ in particular the SIS and EPSG version numbers in the first paragraph.
+* If okay, move those two HTML files to the `../site/main/static/tables/`
directory, overwriting previous files.
+ Revert the hack in `AuthorityCodes` class, then commit:
+
+ {{< highlight bash >}}
+ git commit --message="Update the list CRS and operation methods supported by
Apache SIS $NEW_VERSION."
+ {{< / highlight >}}
## Prepare release notes {#release-notes}
diff --git a/static/tables/CoordinateOperationMethods.html
b/static/tables/CoordinateOperationMethods.html
index d113c62f..16b05f59 100644
--- a/static/tables/CoordinateOperationMethods.html
+++ b/static/tables/CoordinateOperationMethods.html
@@ -15,7 +15,7 @@
<header>
<h1>Apache SIS™ Coordinate Operation Methods</h1>
<p>
- The following tables summarize the coordinate operation methods known
to Apache SIS 1.3
+ The following tables summarize the coordinate operation methods known
to Apache SIS 1.4
together with the recognized parameters. There is three kinds of
parameters:
</p>
<ul class="verbose">
@@ -6759,7 +6759,7 @@
</tr>
<tr>
<th>Aliases:</th>
- <td><span
class="non-epsg">OGC:</span><code>Polar_Stereographic</code>, <span
class="non-epsg">GeoTIFF:</span><code>CT_PolarStereographic</code>, <span
class="non-epsg">Proj4:</span><code>stere</code></td>
+ <td><span
class="non-epsg">OGC:</span><code>Polar_Stereographic</code>, <span
class="non-epsg">Proj4:</span><code>stere</code></td>
</tr>
</table>
<table class="param">
@@ -6849,7 +6849,7 @@
</table>
</details>
</td>
- <td class="sep"></td>
+ <td class="sep">See note ¹</td>
<td class="sep right">[-90</td>
<td class="center">…</td>
<td class="left">90]°</td>
@@ -6976,6 +6976,12 @@
<td class="sep">0 m</td>
</tr>
</table>
+ <table class="footnotes">
+ <tr>
+ <td>¹</td>
+ <td>The only valid entries are ±90° or equivalent in alternative
angle units.</td>
+ </tr>
+ </table>
</blockquote>
</article>
<article>
@@ -6990,7 +6996,7 @@
</tr>
<tr>
<th>Aliases:</th>
- <td><span class="non-epsg">S57:</span><code>Polar
stereographic</code>, <span class="non-epsg">S57:</span><code>PST</code>, <span
class="non-epsg">Proj4:</span><code>stere</code></td>
+ <td><span class="non-epsg">S57:</span><code>Polar
stereographic</code>, <span class="non-epsg">S57:</span><code>PST</code>, <span
class="non-epsg">GeoTIFF:</span><code>CT_PolarStereographic</code></td>
</tr>
</table>
<table class="param">
diff --git a/static/tables/CoordinateReferenceSystems.html
b/static/tables/CoordinateReferenceSystems.html
index 738786ce..242c5ea2 100644
--- a/static/tables/CoordinateReferenceSystems.html
+++ b/static/tables/CoordinateReferenceSystems.html
@@ -12,7 +12,7 @@
<h1>Apache SIS™ Coordinate Reference System (CRS) codes</h1>
<p>This list is generated from the EPSG dataset version 9.9.1, together
with other sources.
All those <cite>Coordinate Reference Systems (CRS)</cite> are supported
by the <a href="https://sis.apache.org";>Apache SIS™</a>
- library version 1.3 (provided that <a
href="https://sis.apache.org/epsg.html";>a connection to an EPSG database
exists</a>),
+ library version 1.4 (provided that <a
href="https://sis.apache.org/epsg.html";>a connection to an EPSG database
exists</a>),
except those with a red text in the last column.
There is 7040 codes, 98% of them being supported.</p>
