This is an automated email from the ASF dual-hosted git repository. mattjuntunen pushed a commit to branch 1.0-release in repository https://gitbox.apache.org/repos/asf/commons-geometry.git
commit f0c0e75f1ffb086c46eae217abfb8a6b3f11dfb2 Author: Matt Juntunen <mattjuntu...@apache.org> AuthorDate: Sun Aug 8 17:17:14 2021 -0400 preparing RC1 --- RELEASE-NOTES.txt | 56 ++++++++- src/changes/release-notes.vm | 140 +++++++++++++++++++++ .../resources/release-notes/RELEASE-NOTES-1.0.txt | 78 ++++++++++++ src/site/xdoc/download_geometry.xml | 26 ++-- src/site/xdoc/release-history.xml | 3 + 5 files changed, 288 insertions(+), 15 deletions(-) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 552bda6..ba2e707 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,4 +1,58 @@ + Apache Commons Geometry 1.0 RELEASE NOTES + +The Apache Commons Geometry team is pleased to announce the release of +commons-geometry-parent-1.0 + +The Apache Commons Geometry project provides geometric types and utilities. + +This is the first major release of Apache Commons Geometry. +Apache Commons Geometry 1.0 contains the following library modules: + commons-geometry-core (requires Java 8+) + commons-geometry-euclidean (requires Java 8+) + commons-geometry-spherical (requires Java 8+) + commons-geometry-io-core (requires Java 8+) + commons-geometry-io-euclidean (requires Java 8+) + +Changes in this version include: + +New features: +o GEOMETRY-118: Add coordinate-specific transform methods to AffineTransformMatrixXD classes, + e.g. "applyX", "applyY", "applyZ". +o GEOMETRY-95: Add solid geometry tutorial. +o GEOMETRY-120: Add SimpleTriangleMeshBuilder.addFace(int[]) method as alternative to + addFace(int, int, int). +o GEOMETRY-117: Add shear methods to AffineTransformMatrix2D. Thanks to Christoph Läubrich. +o GEOMETRY-119: Add VectorXD.normalizeOrNull() methods so that callers can detect normalization + failures without needing to catch an exception. +o GEOMETRY-115: Add modules for IO functionality: commons-geometry-io-core, + commons-geometry-io-euclidean. +o GEOMETRY-108: Add BoundaryList interface and implementation classes. + +Fixed Bugs: +o GEOMETRY-116: Fix incorrect OSGi headers. Reported by Christoph Läubrich. + +Changes: +o GEOMETRY-138: Do not use checked exceptions in IO modules. +o GEOMETRY-13: Use Norms.EUCLIDEAN from Commons Numbers to compute 3D Euclidean norm values. +o GEOMETRY-126: Replace VectorXD.linearCombination methods with VectorXD.Sum classes. Use + Sum class from Commons Numbers for computing internal linear combinations. +o GEOMETRY-124: Replace DoublePrecisionContext with Precision.DoubleEquivalence from + Commons Numbers. +o GEOMETRY-109: Rename the BoundarySourceXX.from() static factory methods to "of" to better + match the JDK's Stream.of() method. +o GEOMETRY-103: Migrate unit tests to JUnit 5. Thanks to Arturo Bernal. + + +For complete information on Apache Commons Geometry, including instructions on how to submit + bug reports, patches, or suggestions for improvement, see the Apache Commons Geometry + website: + +https://commons.apache.org/proper/commons-geometry/ + + +============================================================================= + Apache Commons Geometry 1.0-beta1 RELEASE NOTES The Apache Commons Geometry team is pleased to announce the release of @@ -22,5 +76,3 @@ For complete information on Apache Commons Geometry, including instructions on h reports, patches, or suggestions for improvement, see the Apache Commons Geometry website: https://commons.apache.org/proper/commons-geometry/ - - diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm new file mode 100644 index 0000000..cc1b18c --- /dev/null +++ b/src/changes/release-notes.vm @@ -0,0 +1,140 @@ +## Licensed to the Apache Software Foundation (ASF) under one +## or more contributor license agreements. See the NOTICE file +## distributed with this work for additional information +## regarding copyright ownership. The ASF licenses this file +## to you under the Apache License, Version 2.0 (the +## "License"); you may not use this file except in compliance +## with the License. You may obtain a copy of the License at +## +## http://www.apache.org/licenses/LICENSE-2.0 +## +## Unless required by applicable law or agreed to in writing, +## software distributed under the License is distributed on an +## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +## KIND, either express or implied. See the License for the +## specific language governing permissions and limitations +## under the License. + + ${project.name} ${version} RELEASE NOTES + +The ${developmentTeam} is pleased to announce the release of ${finalName} + +$introduction.replaceAll("(?<!\015)\012", " +") + +## N.B. the available variables are described here: +## http://maven.apache.org/plugins/maven-changes-plugin/examples/using-a-custom-announcement-template.html +## +## Hack to improve layout: replace all pairs of spaces with a single new-line +$release.description.replaceAll(" ", " +") + +#if ($release.getActions().size() == 0) +No changes defined in this version. +#else +Changes in this version include: + +## indent to be used if there is no issue attribute. +## should be the same as the indent in the changes.xml file +## less 2 spaces for the 'o' and trailing space +#set($indent=' ') +#if ($release.getActions('add').size() !=0) +New features: +#foreach($actionItem in $release.getActions('add')) +## Use replaceAll to fix up LF-only line ends on Windows. +#set($action=$actionItem.getAction().replaceAll("\n"," +")) +#if ($actionItem.getIssue()) +#set($issue=$actionItem.getIssue()) +#else +#set($issue="") +#end +#if ($actionItem.getDueTo()) +#set($dueto=$actionItem.getDueTo()) +#else +#set($dueto="") +#end +o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end + +#set($issue="") +#set($dueto="") +#end +#end + +#if ($release.getActions('fix').size() !=0) +Fixed Bugs: +#foreach($actionItem in $release.getActions('fix')) +## Use replaceAll to fix up LF-only line ends on Windows. +#set($action=$actionItem.getAction().replaceAll("\n"," +")) +#if ($actionItem.getIssue()) +#set($issue=$actionItem.getIssue()) +#else +#set($issue="") +#end +#if ($actionItem.getDueTo()) +#set($dueto=$actionItem.getDueTo()) +#else +#set($dueto="") +#end +o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end + +#set($issue="") +#set($dueto="") +#end +#end + +#if ($release.getActions('update').size() !=0) +Changes: +#foreach($actionItem in $release.getActions('update')) +## Use replaceAll to fix up LF-only line ends on Windows. +#set($action=$actionItem.getAction().replaceAll("\n"," +")) +#if ($actionItem.getIssue()) +#set($issue=$actionItem.getIssue()) +#else +#set($issue="") +#end +#if ($actionItem.getDueTo()) +#set($dueto=$actionItem.getDueTo()) +#else +#set($dueto="") +#end +o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end + +#set($issue="") +#set($dueto="") +#end +#end + +#if ($release.getActions('remove').size() !=0) +Removed: +#foreach($actionItem in $release.getActions('remove')) +## Use replaceAll to fix up LF-only line ends on Windows. +#set($action=$actionItem.getAction().replaceAll("\n"," +")) +#if ($actionItem.getIssue()) +#set($issue=$actionItem.getIssue()) +#else +#set($issue="") +#end +#if ($actionItem.getDueTo()) +#set($dueto=$actionItem.getDueTo()) +#else +#set($dueto="") +#end +o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end + +#set($issue="") +#set($dueto="") +#end +#end +## End of main loop +#end + +For complete information on ${project.name}, including instructions on how to submit bug reports, +patches, or suggestions for improvement, see the ${project.name} website: + +${project.url} + + diff --git a/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt new file mode 100644 index 0000000..ba2e707 --- /dev/null +++ b/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt @@ -0,0 +1,78 @@ + + Apache Commons Geometry 1.0 RELEASE NOTES + +The Apache Commons Geometry team is pleased to announce the release of +commons-geometry-parent-1.0 + +The Apache Commons Geometry project provides geometric types and utilities. + +This is the first major release of Apache Commons Geometry. +Apache Commons Geometry 1.0 contains the following library modules: + commons-geometry-core (requires Java 8+) + commons-geometry-euclidean (requires Java 8+) + commons-geometry-spherical (requires Java 8+) + commons-geometry-io-core (requires Java 8+) + commons-geometry-io-euclidean (requires Java 8+) + +Changes in this version include: + +New features: +o GEOMETRY-118: Add coordinate-specific transform methods to AffineTransformMatrixXD classes, + e.g. "applyX", "applyY", "applyZ". +o GEOMETRY-95: Add solid geometry tutorial. +o GEOMETRY-120: Add SimpleTriangleMeshBuilder.addFace(int[]) method as alternative to + addFace(int, int, int). +o GEOMETRY-117: Add shear methods to AffineTransformMatrix2D. Thanks to Christoph Läubrich. +o GEOMETRY-119: Add VectorXD.normalizeOrNull() methods so that callers can detect normalization + failures without needing to catch an exception. +o GEOMETRY-115: Add modules for IO functionality: commons-geometry-io-core, + commons-geometry-io-euclidean. +o GEOMETRY-108: Add BoundaryList interface and implementation classes. + +Fixed Bugs: +o GEOMETRY-116: Fix incorrect OSGi headers. Reported by Christoph Läubrich. + +Changes: +o GEOMETRY-138: Do not use checked exceptions in IO modules. +o GEOMETRY-13: Use Norms.EUCLIDEAN from Commons Numbers to compute 3D Euclidean norm values. +o GEOMETRY-126: Replace VectorXD.linearCombination methods with VectorXD.Sum classes. Use + Sum class from Commons Numbers for computing internal linear combinations. +o GEOMETRY-124: Replace DoublePrecisionContext with Precision.DoubleEquivalence from + Commons Numbers. +o GEOMETRY-109: Rename the BoundarySourceXX.from() static factory methods to "of" to better + match the JDK's Stream.of() method. +o GEOMETRY-103: Migrate unit tests to JUnit 5. Thanks to Arturo Bernal. + + +For complete information on Apache Commons Geometry, including instructions on how to submit + bug reports, patches, or suggestions for improvement, see the Apache Commons Geometry + website: + +https://commons.apache.org/proper/commons-geometry/ + + +============================================================================= + + Apache Commons Geometry 1.0-beta1 RELEASE NOTES + +The Apache Commons Geometry team is pleased to announce the release of +Apache Commons Geometry 1.0-beta1 + +The Apache Commons Geometry project provides geometric types and utilities. + +This is a beta release of Apache Commons Geometry. No guarantees are made regarding the stability +of the API or compatibility with future releases. + +Apache Commons Geometry 1.0-beta1 contains the following library modules: + commons-geometry-core (requires Java 8+) + commons-geometry-euclidean (requires Java 8+) + commons-geometry-spherical (requires Java 8+) + commons-geometry-hull (requires Java 8+) + commons-geometry-enclosing (requires Java 8+) + +No changes defined in this version. + +For complete information on Apache Commons Geometry, including instructions on how to submit bug +reports, patches, or suggestions for improvement, see the Apache Commons Geometry website: + +https://commons.apache.org/proper/commons-geometry/ diff --git a/src/site/xdoc/download_geometry.xml b/src/site/xdoc/download_geometry.xml index 5535862..0a6db06 100644 --- a/src/site/xdoc/download_geometry.xml +++ b/src/site/xdoc/download_geometry.xml @@ -113,32 +113,32 @@ limitations under the License. </p> </subsection> </section> - <section name="Apache Commons Geometry 1.0-beta1 (requires Java 8+)"> + <section name="Apache Commons Geometry 1.0 (requires Java 8+)"> <subsection name="Binaries"> <table> <tr> - <td><a href="[preferred]/commons/geometry/binaries/commons-geometry-1.0-beta1-bin.tar.gz">commons-geometry-1.0-beta1-bin.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-beta1-bin.tar.gz.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-beta1-bin.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/geometry/binaries/commons-geometry-1.0-bin.tar.gz">commons-geometry-1.0-bin.tar.gz</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-bin.tar.gz.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-bin.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/geometry/binaries/commons-geometry-1.0-beta1-bin.zip">commons-geometry-1.0-beta1-bin.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-beta1-bin.zip.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-beta1-bin.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/geometry/binaries/commons-geometry-1.0-bin.zip">commons-geometry-1.0-bin.zip</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-bin.zip.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/binaries/commons-geometry-1.0-bin.zip.asc">pgp</a></td> </tr> </table> </subsection> <subsection name="Source"> <table> <tr> - <td><a href="[preferred]/commons/geometry/source/commons-geometry-1.0-beta1-src.tar.gz">commons-geometry-1.0-beta1-src.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-beta1-src.tar.gz.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-beta1-src.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/geometry/source/commons-geometry-1.0-src.tar.gz">commons-geometry-1.0-src.tar.gz</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-src.tar.gz.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-src.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/geometry/source/commons-geometry-1.0-beta1-src.zip">commons-geometry-1.0-beta1-src.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-beta1-src.zip.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-beta1-src.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/geometry/source/commons-geometry-1.0-src.zip">commons-geometry-1.0-src.zip</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-src.zip.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/geometry/source/commons-geometry-1.0-src.zip.asc">pgp</a></td> </tr> </table> </subsection> diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml index a8388f7..ec9d456 100644 --- a/src/site/xdoc/release-history.xml +++ b/src/site/xdoc/release-history.xml @@ -25,6 +25,9 @@ limitations under the License. <table> <tr><th>Version</th><th>Release date (YYYY-MM-DD)</th><th>Required Java Version</th><th>Release notes</th></tr> <tr> + <td>1.0</td><td>2021-08-15</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.0.txt">release notes for 1.0</a></td> + </tr> + <tr> <td>1.0-beta1</td><td>2020-07-20</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.0-beta1.txt">release notes for 1.0-beta1</a></td> </tr> </table>