This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-jxpath.git
The following commit(s) were added to refs/heads/master by this push:
new 1d3568e Prepare for the next release candidate
1d3568e is described below
commit 1d3568ef07ee56cb7669f7e849b74cde53302da6
Author: Gary D. Gregory <[email protected]>
AuthorDate: Sat Apr 12 21:49:24 2025 +0000
Prepare for the next release candidate
---
CONTRIBUTING.md | 26 ++++---
NOTICE.txt | 2 +-
README.md | 46 +++++++----
RELEASE-NOTES.txt | 112 ++++++++++++++++++++++++++
pom.xml | 1 +
src/changes/changes.xml | 2 +-
src/changes/release-notes.vm | 160 ++++++++++++++++++++++++++++++++++++++
src/site/xdoc/download_jxpath.xml | 80 ++++++++++++-------
src/site/xdoc/issue-tracking.xml | 14 ++--
src/site/xdoc/mail-lists.xml | 97 +++++++++++++----------
10 files changed, 433 insertions(+), 107 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index dccacaa..43a201f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,7 +6,7 @@
(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
+ https://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,
@@ -41,37 +41,40 @@
Contributing to Apache Commons JXPath
======================
-You have found a bug or you have an idea for a cool new feature? Contributing
code is a great way to give something back to
-the open source community. Before you dig right into the code there are a few
guidelines that we need contributors to
-follow so that we can have a chance of keeping on top of things.
+Have you found a bug or have an idea for a cool new feature? Contributing code
is a great way to give something back to the open-source community.
+Before you dig right into the code, we need contributors to follow a few
guidelines to have a chance of keeping on top of things.
Getting Started
---------------
+ Make sure you have a [JIRA account](https://issues.apache.org/jira/).
-+ Make sure you have a [GitHub account](https://github.com/signup/free).
++ Make sure you have a [GitHub account](https://github.com/signup/free). This
is not essential, but makes providing patches much easier.
+ If you're planning to implement a new feature it makes sense to discuss your
changes on the [dev list](https://commons.apache.org/mail-lists.html) first.
This way you can make sure you're not wasting your time on something that isn't
considered to be in Apache Commons JXPath's scope.
+ Submit a [Jira Ticket][jira] for your issue, assuming one does not already
exist.
+ Clearly describe the issue including steps to reproduce when it is a bug.
+ Make sure you fill in the earliest version that you know has the issue.
+ Find the corresponding [repository on
GitHub](https://github.com/apache/?query=commons-),
-[fork](https://help.github.com/articles/fork-a-repo/) and check out your
forked repository.
+[fork](https://help.github.com/articles/fork-a-repo/) and check out your
forked repository. If you don't have a GitHub account, you can still clone the
Commons repository.
Making Changes
--------------
+ Create a _topic branch_ for your isolated work.
* Usually you should base your branch from the `master` branch.
- * A good topic branch name can be the JIRA bug id plus a keyword, for
example, `JXPATH-123-InputStream`.
+ * A good topic branch name can be the JIRA bug ID plus a keyword, e.g.
`JXPATH-123-InputStream`.
* If you have submitted multiple JIRA issues, try to maintain separate
branches and pull requests.
+ Make commits of logical units.
* Make sure your commit messages are meaningful and in the proper format.
Your commit message should contain the key of the JIRA issue.
- * For example, `[JXPATH-123] Close input stream earlier`
+ * For example, `[JXPATH-123] Close input stream sooner`
+ Respect the original code style:
+ Only use spaces for indentation; you can check for unnecessary whitespace
with `git diff` before committing.
+ Create minimal diffs - disable _On Save_ actions like _Reformat Source
Code_ or _Organize Imports_. If you feel the source code should be reformatted
create a separate PR for this change first.
-+ Make sure you have added the necessary tests for your changes, typically in
`src/test/java`.
-+ Run all the tests with `mvn clean verify` to assure nothing else was
accidentally broken.
++ Write unit tests that match behavioral changes, where the tests fail if the
changes to the runtime are not applied. This may not always be possible but is
a best-practice.
+Unit tests are typically in the `src/test/java` directory.
++ Run a successful build using the default [Maven](https://maven.apache.org/)
goal with `mvn`; that's `mvn` on the command line by itself.
++ Write a pull request description that is detailed enough to understand what
the pull request does, how, and why.
++ Each commit in the pull request should have a meaningful subject line and
body. Note that commits might be squashed by a maintainer on merge.
+
Making Trivial Changes
----------------------
@@ -103,12 +106,11 @@ Additional Resources
--------------------
+ [Contributing patches](https://commons.apache.org/patches.html)
-+ [Apache Commons JXpath JIRA project page][jira]
++ [Apache Commons JXPath JIRA project page][jira]
+ [Contributor License Agreement][cla]
+ [General GitHub documentation](https://help.github.com/)
+ [GitHub pull request
documentation](https://help.github.com/articles/creating-a-pull-request/)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.net`
[cla]:https://www.apache.org/licenses/#clas
[jira]:https://issues.apache.org/jira/browse/JXPATH
diff --git a/NOTICE.txt b/NOTICE.txt
index 934e2d8..16d34f3 100644
--- a/NOTICE.txt
+++ b/NOTICE.txt
@@ -2,4 +2,4 @@ Apache Commons JXPath
Copyright 2001-2025 The Apache Software Foundation
This product includes software developed at
-The Apache Software Foundation (http://www.apache.org/).
+The Apache Software Foundation (https://www.apache.org/).
diff --git a/README.md b/README.md
index 2b5853a..4714d68 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
(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
+ https://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,
@@ -25,7 +25,7 @@
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
- | 1) Re-generate using: mvn commons:readme-md |
+ | 1) Re-generate using: mvn commons-build:readme-md |
| |
| 2) Set the following properties in the component's pom: |
| - commons.componentid (required, alphabetic, lower case) |
@@ -45,6 +45,9 @@ Apache Commons JXPath
[](https://github.com/apache/commons-jxpath/actions/workflows/maven.yml)
[](https://search.maven.org/artifact/commons-jxpath/commons-jxpath)
+[](https://javadoc.io/doc/commons-jxpath/commons-jxpath/1.4.0)
+[](https://github.com/apache/commons-jxpath/actions/workflows/codeql-analysis.yml)
+[](https://api.securityscorecards.dev/projects/github.com/apache/commons-jxpath)
A Java-based implementation of XPath 1.0 that, in addition to XML processing,
can inspect/modify Java object graphs (the library's explicit purpose) and even
mixed Java/XML structures.
@@ -52,11 +55,11 @@ Documentation
-------------
More information can be found on the [Apache Commons JXPath
homepage](https://commons.apache.org/proper/commons-jxpath).
-The
[Javadoc](https://commons.apache.org/proper/commons-jxpath/javadocs/api-release)
can be browsed.
+The [Javadoc](https://commons.apache.org/proper/commons-jxpath/apidocs) can be
browsed.
Questions related to the usage of Apache Commons JXPath should be posted to
the [user mailing list](https://commons.apache.org/mail-lists.html).
-Where can I get the latest release?
------------------------------------
+Getting the latest release
+--------------------------
You can download source and binaries from our [download
page](https://commons.apache.org/proper/commons-jxpath/download_jxpath.cgi).
Alternatively, you can pull it from the central Maven repositories:
@@ -65,39 +68,52 @@ Alternatively, you can pull it from the central Maven
repositories:
<dependency>
<groupId>commons-jxpath</groupId>
<artifactId>commons-jxpath</artifactId>
- <version>1.3</version>
+ <version>1.4.0</version>
</dependency>
```
+Building
+--------
+
+Building requires a Java JDK and [Apache Maven](https://maven.apache.org/).
+The required Java version is found in the `pom.xml` as the
`maven.compiler.source` property.
+
+From a command shell, run `mvn` without arguments to invoke the default Maven
goal to run all tests and checks.
+
Contributing
------------
-We accept Pull Requests via GitHub. The [developer mailing list][ml] is the
main channel of communication for contributors.
+We accept Pull Requests via GitHub. The [developer mailing
list](https://commons.apache.org/mail-lists.html) is the main channel of
communication for contributors.
There are some guidelines which will make applying PRs easier for us:
+ No tabs! Please use spaces for indentation.
-+ Respect the code style.
++ Respect the existing code style for each file.
+ Create minimal diffs - disable on save actions like reformat source code or
organize imports. If you feel the source code should be reformatted create a
separate PR for this change.
-+ Provide JUnit tests for your changes and make sure your changes don't break
any existing tests by running ```mvn clean test```.
++ Provide JUnit tests for your changes and make sure your changes don't break
any existing tests by running `mvn`.
++ Before you pushing a PR, run `mvn` (by itself), this runs the default goal,
which contains all build checks.
++ To see the code coverage report, regardless of coverage failures, run `mvn
clean site -Dcommons.jacoco.haltOnFailure=false`
If you plan to contribute on a regular basis, please consider filing a
[contributor license agreement](https://www.apache.org/licenses/#clas).
You can learn more about contributing via GitHub in our [contribution
guidelines](CONTRIBUTING.md).
License
-------
-This code is under the [Apache Licence
v2](https://www.apache.org/licenses/LICENSE-2.0).
+This code is licensed under the [Apache License
v2](https://www.apache.org/licenses/LICENSE-2.0).
See the `NOTICE.txt` file for required notices and attributions.
-Donations
----------
-You like Apache Commons JXPath? Then [donate back to the
ASF](https://www.apache.org/foundation/contributing.html) to support the
development.
+Donating
+--------
+You like Apache Commons JXPath? Then [donate back to the
ASF](https://www.apache.org/foundation/contributing.html) to support
development.
Additional Resources
--------------------
+ [Apache Commons Homepage](https://commons.apache.org/)
+ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/JXPATH)
++ [Apache Commons Slack Channel](https://the-asf.slack.com/archives/C60NVB8AD)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.org`
-[ml]:https://commons.apache.org/mail-lists.html
+Apache Commons Components
+-------------------------
+
+Please see the [list of components](https://commons.apache.org/components.html)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
new file mode 100644
index 0000000..6d06e8f
--- /dev/null
+++ b/RELEASE-NOTES.txt
@@ -0,0 +1,112 @@
+Apache Commons JXPath 1.4.0 Release Notes
+-----------------------------------------
+
+The Apache Commons JXPath team is pleased to announce the release of Apache
Commons JXPath 1.4.0.
+
+Introduction
+------------
+
+A Java-based implementation of XPath 1.0 that, in addition to XML processing,
can inspect/modify Java object graphs (the library's explicit purpose) and even
mixed Java/XML structures.
+
+New features and bug fixes.
+
+New features
+------------
+
+o JXPATH-123: XPath function "ends-with" is not implemented (although
"starts-with" is).
+
+Fixed Bugs
+----------
+
+o JXPATH-172: Clarify Javadoc of JXPathContext#getPointer. Thanks to Michele
Vivoda.
+o JXPATH-113: NullPointerException in ChildContext when document only
contains an empty root node. Thanks to Michele Vivoda.
+o JXPATH-160: ValueUtils.getValue throws exception with set and index above
size. Thanks to Stefan Albrecht, Michele Vivoda, Uwe Barthel.
+o JXPATH-162: Concurrency problem for JXPathContextFactory.factoryImplName
static field. Thanks to Uwe Barthel.
+o JXPATH-141: FunctionLibrary Multithreading issue.
+o JXPATH-131: Bean exception handling. Thanks to Gabriel Buades Rubio.
+o JXPATH-128: JXPath support for LazyDynaBean is broken. Thanks to Gabriel
Buades Rubio.
+o JXPATH-129: MethodLookupUtils#matchType uses TypeUtils#canConvert which
causes "Ambiguous method call" exception.
+o JXPATH-153: Wrong entry IMPORT-PACKAGE in the file MANIFEST.MF for jdom and
commons-beanutils.
+o JXPATH-153: Change dynamic class loading to consult context class loader.
Thanks to John Trimble.
+o JXPATH-152: Concurrent access on hashmap of JXPathIntrospector.
+o Fix possible NPE in PackageFunctions.getFunction(String, String,
Object[]).
+o JDOMNodePointer.compareChildNodePointers() now throws
IllegalStateException instead of RuntimeException. Thanks to Gary Gregory.
+o ValueUtils.setValue() now throws IllegalArgumentException instead
of RuntimeException. Thanks to Gary Gregory.
+o ClassLoaderUtil.toCanonicalName() now calls
Objects.requireNonNull() instead of throwing a RuntimeException. Thanks to Gary
Gregory.
+o XMLDocumentContainer.XMLDocumentContainer(Source) now calls
Objects.requireNonNull() instead of throwing a RuntimeException. Thanks to Gary
Gregory.
+o [StepSecurity] CI: Harden GitHub Actions #66. Thanks to
step-security-bot, Gary Gregory.
+o Add missing Javadoc. Thanks to Gary Gregory.
+o Fix PMD UnnecessaryFullyQualifiedName. Thanks to Gary Gregory.
+o Add generics to JXPathContext.iterate(String). Thanks to Gary
Gregory.
+o Add generics to JXPathContext.iteratePointers(String). Thanks to
Gary Gregory.
+o Add generics to JXPathContext.decimalFormats. Thanks to Gary
Gregory.
+o Migrate tests to JUnit5 #214. Thanks to strangelookingnerd.
+o Replace try-catch constructs in tests with assertThrows #215.
Thanks to strangelookingnerd, Gary Gregory.
+o Use generics internally. Thanks to Gary Gregory.
+o NodeSet.getPointers() is now typed with generics. Thanks to Gary
Gregory.
+o ServletContextHandler.collectPropertyNames(HashSet, Object) is now
typed with generics. Thanks to Gary Gregory.
+o Deprecate ClassLoaderUtil.ClassLoaderUtil(). Thanks to Gary
Gregory.
+o Deprecate MethodLookupUtils.MethodLookupUtils(). Thanks to Gary
Gregory.
+o Deprecate KeyManagerUtils.KeyManagerUtils(). Thanks to Gary
Gregory.
+o Deprecate TypeUtils.TypeUtils(). Thanks to Gary Gregory.
+o Deprecate ValueUtils.ValueUtils(). Thanks to Gary Gregory.
+o PageScopeContext.getAttributeNames() is now typed with generics.
Thanks to Gary Gregory.
+o Functions.getUsedNamespaces() is now typed with generics. Thanks to
Gary Gregory.
+o JXPathException now reuses its superclass' Throwable cause. Thanks
to Gary Gregory.
+o Bump JXPathException serialVersionUID from 4306409701468017766L to
2L. Thanks to Gary Gregory.
+o JXPathContextFactoryConfigurationError now reuses its superclass'
Throwable cause. Thanks to Gary Gregory.
+o Bump JXPathContextFactoryConfigurationError serialVersionUID from
1L to 2L. Thanks to Gary Gregory.
+o Deprecate SimplePathInterpreter.SimplePathInterpreter(). Thanks to
Gary Gregory.
+o Deprecate JXPathServletContexts.JXPathServletContexts(). Thanks to
Gary Gregory.
+o Deprecate JXPathIntrospector.JXPathIntrospector(). Thanks to Gary
Gregory.
+o Deprecate InfoSetUtil.InfoSetUtil(). Thanks to Gary Gregory.
+o Deprecate Constants.Constants(). Thanks to Gary Gregory.
+o Deprecate Parser.Parser(). Thanks to Gary Gregory.
+o JXPathException.JXPathException(Throwable) now remembers its
Throwable cause argument. Thanks to Gary Gregory.
+o Make the private DOMNodePointer.id field final. Thanks to Gary
Gregory.
+o Make the private NullPointer.id field final. Thanks to Gary
Gregory.
+o Make the private NullPointer.qname field final. Thanks to Gary
Gregory.
+o Make the private JDOMNodePointer.id field final. Thanks to Gary
Gregory.
+o ExpressionContext.getContextNodeList() now uses generics. Thanks to
Gary Gregory.
+o BasicTypeConverter.unmodifiableCollection(Collection) now uses
generics. Thanks to Gary Gregory.
+o Fix PMD AvoidDecimalLiteralsInBigDecimalConstructor in
org.apache.commons.jxpath.util.BasicTypeConverter.allocateNumber(Class,
double). Thanks to Gary Gregory. PMD.
+o
org.apache.commons.jxpath.ri.JXPathContextReferenceImpl.iteratePointers(String)
now uses generics. Thanks to Gary Gregory.
+o
org.apache.commons.jxpath.ri.JXPathContextReferenceImpl.iteratePointers(String,
Expression) now uses generics. Thanks to Gary Gregory.
+o
org.apache.commons.jxpath.CompiledExpression.iteratePointers(JXPathContext) now
uses generics. Thanks to Gary Gregory.
+o
org.apache.commons.jxpath.JXPathCompiledExpression.iteratePointers(JXPathContext)
now uses generics. Thanks to Gary Gregory.
+o
org.apache.commons.jxpath.util.ClassLoaderUtil.getClass(ClassLoader, String)
now uses generics. Thanks to Gary Gregory.
+o
org.apache.commons.jxpath.util.ClassLoaderUtil.getClass(ClassLoader, String,
boolean) now uses generics. Thanks to Gary Gregory.
+o org.apache.commons.jxpath.util.ClassLoaderUtil.getClass(String) now
uses generics. Thanks to Gary Gregory.
+o org.apache.commons.jxpath.util.ClassLoaderUtil.getClass(String,
boolean) now uses generics. Thanks to Gary Gregory.
+
+Changes
+-------
+
+o Bump commons-parent from 54 to 81 #45, #49, #64, #110, #121, #403,
#167, #173, #176, #181, #185, #188, #196. Thanks to Dependabot, Gary Gregory.
+o JXPATH-184: Bump Java to 8. Thanks to britter, Gary Gregory.
+o Bump JUnit 3.8.1 to 4.13.2. Thanks to britter, Gary Gregory.
+o Bump commons-logging from 1.1.1 to 1.3.5 #34, #129, #147, #160,
#174. Thanks to Dependabot, Gary Gregory.
+o Bump commons-beanutils from 1.8.2 to 1.10.1 #24. Thanks to
Dependabot, Gary Gregory.
+o Bump taglist-maven-plugin from 2.2 to 3.0.0 #32. Thanks to
Dependabot.
+o Bump servlet-api from 2.4 to 2.5 #29. Thanks to Dependabot.
+o Bump JDOM from jdom:jdom 1.0 to org.jdom:jdom 1.1.3. Thanks to
Dependabot.
+o Bump org.codehaus.mojo:taglist-maven-plugin from 3.0.0 to 3.2.1
#161, #194. Thanks to Dependabot.
+
+Removed
+-------
+
+o Remove obsolete Apache RAT file. Thanks to Gary Gregory. o
Remove obsolete Apache Ant files. Thanks to Gary Gregory. o Remove
obsolete src/conf/MANIFEST.MF file. Thanks to Gary Gregory. o Remove
obsolete maven-surefire-plugin configuration. Configuration is done in the
parent POM. Thanks to Gary Gregory. o Remove obsolete
maven-assembly-plugin configuration. Configuration is done in the parent POM.
Thanks to Gary Gregory. o Remove o [...]
+Historical list of changes:
https://commons.apache.org/proper/commons-jxpath/changes.html
+
+For complete information on Apache Commons JXPath, including instructions on
how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons JXPath website:
+
+https://commons.apache.org/proper/commons-jxpath/
+
+Download page: https://commons.apache.org/proper/commons-jxpath/download_io.cgi
+
+Have fun!
+-Apache Commons Team
+
+------------------------------------------------------------------------------
+
diff --git a/pom.xml b/pom.xml
index 2473a2e..550c509 100644
--- a/pom.xml
+++ b/pom.xml
@@ -48,6 +48,7 @@
<commons.componentid>jxpath</commons.componentid>
<commons.module.name>org.apache.commons.jxpath</commons.module.name>
<commons.release.version>1.4.0</commons.release.version>
+ <commons.release.next>1.4.1</commons.release.next>
<commons.release.isDistModule>true</commons.release.isDistModule>
<commons.rc.version>RC1</commons.rc.version>
<commons.bc.version>1.3</commons.bc.version>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 4b7d7f3..53cbb4f 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -47,7 +47,7 @@ The <action> type attribute can be add,update,fix,remove.
</properties>
<body>
<!-- The release date is the date RC is cut -->
- <release version="1.4.0" date="YYYY-MM-DD" description="New features and
bug fixes.">
+ <release version="1.4.0" date="2025-04-12" description="New features and
bug fixes.">
<!-- FIX -->
<action issue="JXPATH-172" dev="britter" type="fix" due-to="Michele
Vivoda">
Clarify Javadoc of JXPathContext#getPointer.
diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm
new file mode 100644
index 0000000..8715355
--- /dev/null
+++ b/src/changes/release-notes.vm
@@ -0,0 +1,160 @@
+## 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 ${project.name}
${version}.
+
+Introduction
+------------
+
+$introduction.replaceAll("(?<!\015)\012", "
+")
+
+##
+## 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
+## 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 '*' 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
+##
+
+Historical list of changes: ${project.url}changes.html
+
+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}
+
+Download page: ${project.url}download_io.cgi
+
+Have fun!
+-Apache Commons Team
+
+------------------------------------------------------------------------------
+
diff --git a/src/site/xdoc/download_jxpath.xml
b/src/site/xdoc/download_jxpath.xml
index 71ab569..754511e 100644
--- a/src/site/xdoc/download_jxpath.xml
+++ b/src/site/xdoc/download_jxpath.xml
@@ -7,7 +7,7 @@ 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
+ https://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,
@@ -26,15 +26,28 @@ limitations under the License.
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
- | 1) Re-generate using: mvn commons:download-page |
+ | 1) Re-generate using: mvn commons-build:download-page |
| |
| 2) Set the following properties in the component's pom: |
- | - commons.componentid (required, alphabetic, lower case) |
+ | - commons.componentid (required, alphabetic, lower case) |
| - commons.release.version (required) |
- | - commons.binary.suffix (optional) |
+ | - commons.release.name (required) |
+ | - commons.binary.suffix (optional) |
| (defaults to "-bin", set to "" for pre-maven2 releases) |
+ | - commons.release.desc (optional) |
+ | - commons.release.subdir (optional) |
+ | - commons.release.hash (optional, lowercase, default sha512) |
+ | |
+ | - commons.release.[234].version (conditional) |
+ | - commons.release.[234].name (conditional) |
+ | - commons.release.[234].binary.suffix (optional) |
+ | - commons.release.[234].desc (optional) |
+ | - commons.release.[234].subdir (optional) |
+ | - commons.release.[234].hash (optional, lowercase, [sha512])|
| |
| 3) Example Properties |
+ | (commons.release.name inherited by parent: |
+ | ${project.artifactId}-${commons.release.version} |
| |
| <properties> |
| <commons.componentid>math</commons.componentid> |
@@ -43,20 +56,22 @@ limitations under the License.
| |
+======================================================================+
-->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
https://maven.apache.org/xsd/xdoc-2.0.xsd">
<properties>
- <title>Download Commons JXPath</title>
+ <title>Download Apache Commons JXPath</title>
<author email="[email protected]">Apache Commons Team</author>
</properties>
<body>
- <section name="Download Commons JXPath">
+ <section name="Download Apache Commons JXPath">
<subsection name="Using a Mirror">
<p>
We recommend you use a mirror to download our release
- builds, but you <strong>must</strong> verify the integrity of
- the downloaded files using signatures downloaded from our main
+ builds, but you <strong>must</strong> <a
href="https://www.apache.org/info/verification.html">verify the integrity</a> of
+ the downloaded files using signatures downloaded from our main
distribution directories. Recent releases (48 hours) may not yet
- be available from the mirrors.
+ be available from all the mirrors.
</p>
<p>
@@ -66,12 +81,12 @@ limitations under the License.
mirrors (at the end of the mirrors list) that should be
available.
<br></br>
- [if-any logo]<a href="[link]"><img align="right" src="[logo]"
border="0"></img></a>[end]
+ [if-any logo]<a href="[link]"><img align="right" src="[logo]"
border="0" alt="Logo"></img></a>[end]
</p>
<form action="[location]" method="get" id="SelectMirror">
<p>
- Other mirrors:
+ Other mirrors:
<select name="Preferred">
[if-any http]
[for http]<option value="[http]">[http]</option>[end]
@@ -88,39 +103,44 @@ limitations under the License.
</form>
<p>
- The <a href="http://www.apache.org/dist/commons/KEYS">KEYS</a>
- link links to the code signing keys used to sign the product.
- The <code>PGP</code> link downloads the OpenPGP compatible signature
from our main site.
- The <code>MD5</code> link downloads the checksum from the main site.
+ It is essential that you
+ <a href="https://www.apache.org/info/verification.html">verify the
integrity</a>
+ of downloaded files, preferably using the <code>PGP</code> signature
(<code>*.asc</code> files);
+ failing that using the <code>SHA512</code> hash (<code>*.sha512</code>
checksum files).
+ </p>
+ <p>
+ The <a href="https://downloads.apache.org/commons/KEYS">KEYS</a>
+ file contains the public PGP keys used by Apache Commons developers
+ to sign releases.
</p>
</subsection>
</section>
- <section name="Commons JXPath 1.3 ">
+ <section name="Apache Commons JXPath 1.4.0 (Java 8 or above)">
<subsection name="Binaries">
<table>
<tr>
- <td><a
href="[preferred]/commons/jxpath/binaries/commons-jxpath-1.3-bin.tar.gz">commons-jxpath-1.3-bin.tar.gz</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/binaries/commons-jxpath-1.3-bin.tar.gz.md5">md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/binaries/commons-jxpath-1.3-bin.tar.gz.asc">pgp</a></td>
+ <td><a
href="[preferred]/commons/jxpath/binaries/commons-jxpath-1.4.0-bin.tar.gz">commons-jxpath-1.4.0-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/binaries/commons-jxpath-1.4.0-bin.tar.gz.sha512">sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/binaries/commons-jxpath-1.4.0-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/jxpath/binaries/commons-jxpath-1.3-bin.zip">commons-jxpath-1.3-bin.zip</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/binaries/commons-jxpath-1.3-bin.zip.md5">md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/binaries/commons-jxpath-1.3-bin.zip.asc">pgp</a></td>
+ <td><a
href="[preferred]/commons/jxpath/binaries/commons-jxpath-1.4.0-bin.zip">commons-jxpath-1.4.0-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/binaries/commons-jxpath-1.4.0-bin.zip.sha512">sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/binaries/commons-jxpath-1.4.0-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a
href="[preferred]/commons/jxpath/source/commons-jxpath-1.3-src.tar.gz">commons-jxpath-1.3-src.tar.gz</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/source/commons-jxpath-1.3-src.tar.gz.md5">md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/source/commons-jxpath-1.3-src.tar.gz.asc">pgp</a></td>
+ <td><a
href="[preferred]/commons/jxpath/source/commons-jxpath-1.4.0-src.tar.gz">commons-jxpath-1.4.0-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/source/commons-jxpath-1.4.0-src.tar.gz.sha512">sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/source/commons-jxpath-1.4.0-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/jxpath/source/commons-jxpath-1.3-src.zip">commons-jxpath-1.3-src.zip</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/source/commons-jxpath-1.3-src.zip.md5">md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/jxpath/source/commons-jxpath-1.3-src.zip.asc">pgp</a></td>
+ <td><a
href="[preferred]/commons/jxpath/source/commons-jxpath-1.4.0-src.zip">commons-jxpath-1.4.0-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/source/commons-jxpath-1.4.0-src.zip.sha512">sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/jxpath/source/commons-jxpath-1.4.0-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
@@ -131,7 +151,7 @@ limitations under the License.
</p>
<ul>
<li class="download"><a href="[preferred]/commons/jxpath/">browse
download area</a></li>
- <li><a
href="http://archive.apache.org/dist/commons/jxpath/">archives...</a></li>
+ <li><a
href="https://archive.apache.org/dist/commons/jxpath/">archives...</a></li>
</ul>
</section>
</body>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index a730bce..7a94c2b 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -7,7 +7,7 @@ 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
+ https://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,
@@ -41,10 +41,12 @@ limitations under the License.
| |
+======================================================================+
-->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
https://maven.apache.org/xsd/xdoc-2.0.xsd">
<properties>
<title>Apache Commons JXPath Issue tracking</title>
- <author email="[email protected]">Apache Commons Documentation
Team</author>
+ <author email="[email protected]">Apache Commons Team</author>
</properties>
<body>
@@ -64,6 +66,7 @@ limitations under the License.
<p>
If you would like to report a bug, or raise an enhancement request with
Apache Commons JXPath please do the following:
+ </p>
<ol>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310480&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">Search
existing open bugs</a>.
If you find your issue listed then please add a comment with your
details.</li>
@@ -73,16 +76,15 @@ limitations under the License.
<li>Submit either a <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310480&issuetype=1&priority=4&assignee=-1">bug
report</a>
or <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310480&issuetype=4&priority=4&assignee=-1">enhancement
request</a>.</li>
</ol>
- </p>
<p>
Please also remember these points:
+ </p>
<ul>
<li>the more information you provide, the better we can help you</li>
<li>test cases are vital, particularly for any proposed
enhancements</li>
<li>the developers of Apache Commons JXPath are all unpaid
volunteers</li>
</ul>
- </p>
<p>
For more information on creating patches see the
@@ -91,12 +93,12 @@ limitations under the License.
<p>
You may also find these links useful:
+ </p>
<ul>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310480&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">All
Open Apache Commons JXPath bugs</a></li>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310480&sorter/field=issuekey&sorter/order=DESC&status=5&status=6">All
Resolved Apache Commons JXPath bugs</a></li>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310480&sorter/field=issuekey&sorter/order=DESC">All
Apache Commons JXPath bugs</a></li>
</ul>
- </p>
</section>
</body>
</document>
diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml
index 086551c..1c58f0c 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -7,7 +7,7 @@ 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
+ https://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,
@@ -26,7 +26,7 @@ limitations under the License.
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
- | 1) Re-generate using: mvn commons:mail-page |
+ | 1) Re-generate using: mvn commons-build:mail-page |
| |
| 2) Set the following properties in the component's pom: |
| - commons.componentid (required, alphabetic, lower case) |
@@ -39,43 +39,50 @@ limitations under the License.
| |
+======================================================================+
-->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
https://maven.apache.org/xsd/xdoc-2.0.xsd">
<properties>
- <title>Commons JXPath Mailing Lists</title>
+ <title>Apache Commons JXPath Mailing Lists</title>
<author email="[email protected]">Apache Commons Team</author>
</properties>
<body>
<section name="Overview">
<p>
- <a href="index.html">Commons JXPath</a> shares mailing lists with all
the other
- <a href="http://commons.apache.org/components.html">Commons
Components</a>.
+ <a href="index.html">Apache Commons JXPath</a> shares mailing lists
with all the other
+ <a href="https://commons.apache.org/components.html">Commons
Components</a>.
To make it easier for people to only read messages related to
components they are interested in,
the convention in Commons is to prefix the subject line of messages
with the component's name,
for example:
- <ul>
- <li>[jxpath] Problem with the ...</li>
- </ul>
</p>
+ <ul>
+ <li>[jxpath] Problem with the ...</li>
+ </ul>
<p>
- Questions related to the usage of Commons JXPath should be posted to
the
- <a href="http://mail-archives.apache.org/mod_mbox/commons-user/">User
List</a>.
+ Questions related to the usage of Apache Commons JXPath should be
posted to the
+ <a
href="https://lists.apache.org/[email protected]">User List</a>.
<br />
- The <a
href="http://mail-archives.apache.org/mod_mbox/commons-dev/">Developer List</a>
- is for questions and discussion related to the development of Commons
JXPath.
+ The <a
href="https://lists.apache.org/[email protected]">Developer
List</a>
+ is for questions and discussion related to the development of Apache
Commons JXPath.
<br />
Please do not cross-post; developers are also subscribed to the user
list.
+ <br />
+ You must be subscribed to post to the mailing lists. Follow the
Subscribe links below
+ to subscribe.
</p>
<p>
- <strong>Note:</strong> please don't send patches or attachments to any
of the mailing lists.
- Patches are best handled via the <a href="issue-tracking.html">Issue
Tracking</a> system.
- Otherwise, please upload the file to a public server and include the
URL in the mail.
+ <strong>Note:</strong> please don't send patches or attachments to any
of the mailing lists;
+ most of the lists are set up to drop attachments.
+ Patches are best handled via the <a href="issue-tracking.html">Issue
Tracking</a> system.
+ If you have a GitHub account, most components also accept PRs (pull
requests).
+ Otherwise, please upload the file to a public server and include the
URL in the mail.
</p>
</section>
- <section name="Commons JXPath Mailing Lists">
+ <section name="Apache Commons JXPath Mailing Lists">
<p>
- <strong>Please prefix the subject line of any messages for <a
href="index.html">Commons JXPath</a>
+ <strong>Please prefix the subject line of any messages for <a
href="index.html">Apache Commons JXPath</a>
with <i>[jxpath]</i></strong> - <i>thanks!</i>
<br />
<br />
@@ -96,16 +103,17 @@ limitations under the License.
<td>
<strong>Commons User List</strong>
<br /><br />
- Questions on using Commons JXPath.
+ Questions on using Apache Commons JXPath.
<br /><br />
</td>
<td><a
href="mailto:[email protected]">Subscribe</a></td>
<td><a
href="mailto:[email protected]">Unsubscribe</a></td>
<td><a
href="mailto:[email protected]?subject=[jxpath]">Post</a></td>
- <td><a
href="http://mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a></td>
- <td><a
href="http://markmail.org/list/org.apache.commons.users/">markmail.org</a><br />
- <a
href="http://www.mail-archive.com/[email protected]/">www.mail-archive.com</a><br
/>
- <a
href="http://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
+ <td>
+ <a
href="https://lists.apache.org/[email protected]">lists.apache.org</a>
+ </td>
+ <td>
+ <a
href="https://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
</td>
</tr>
@@ -114,16 +122,17 @@ limitations under the License.
<td>
<strong>Commons Developer List</strong>
<br /><br />
- Discussion of development of Commons JXPath.
+ Discussion of development of Apache Commons JXPath.
<br /><br />
</td>
<td><a
href="mailto:[email protected]">Subscribe</a></td>
<td><a
href="mailto:[email protected]">Unsubscribe</a></td>
<td><a
href="mailto:[email protected]?subject=[jxpath]">Post</a></td>
- <td><a
href="http://mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a></td>
- <td><a
href="http://markmail.org/list/org.apache.commons.dev/">markmail.org</a><br />
- <a
href="http://www.mail-archive.com/[email protected]/">www.mail-archive.com</a><br
/>
- <a
href="http://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
+ <td>
+ <a
href="https://lists.apache.org/[email protected]">lists.apache.org</a>
+ </td>
+ <td>
+ <a
href="https://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
</td>
</tr>
@@ -138,9 +147,11 @@ limitations under the License.
<td><a
href="mailto:[email protected]">Subscribe</a></td>
<td><a
href="mailto:[email protected]">Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a
href="http://mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a></td>
- <td><a
href="http://markmail.org/list/org.apache.commons.issues/">markmail.org</a><br
/>
- <a
href="http://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
+ <td>
+ <a
href="https://lists.apache.org/[email protected]">lists.apache.org</a>
+ </td>
+ <td>
+ <a
href="https://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
</td>
</tr>
@@ -149,15 +160,17 @@ limitations under the License.
<td>
<strong>Commons Commits List</strong>
<br /><br />
- Only for e-mails automatically generated by the <a
href="source-repository.html">source control</a> sytem.
+ Only for e-mails automatically generated by the <a
href="scm.html">source control</a> system.
<br /><br />
</td>
<td><a
href="mailto:[email protected]">Subscribe</a></td>
<td><a
href="mailto:[email protected]">Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a
href="http://mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a></td>
- <td><a
href="http://markmail.org/list/org.apache.commons.commits/">markmail.org</a><br
/>
- <a
href="http://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
+ <td>
+ <a
href="https://lists.apache.org/[email protected]">lists.apache.org</a>
+ </td>
+ <td>
+ <a
href="https://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
</td>
</tr>
@@ -185,14 +198,14 @@ limitations under the License.
General announcements of Apache project releases.
<br /><br />
</td>
- <td><a class="externalLink"
href="mailto:[email protected]">Subscribe</a></td>
- <td><a class="externalLink"
href="mailto:[email protected]">Unsubscribe</a></td>
+ <td><a class="externalLink"
href="mailto:[email protected]">Subscribe</a></td>
+ <td><a class="externalLink"
href="mailto:[email protected]">Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a class="externalLink"
href="http://mail-archives.apache.org/mod_mbox/www-announce/">mail-archives.apache.org</a></td>
- <td><a class="externalLink"
href="http://markmail.org/list/org.apache.announce/">markmail.org</a><br />
- <a class="externalLink"
href="http://old.nabble.com/Apache-News-and-Announce-f109.html">old.nabble.com</a><br
/>
- <a class="externalLink"
href="http://www.mail-archive.com/[email protected]/">www.mail-archive.com</a><br
/>
- <a class="externalLink"
href="http://news.gmane.org/gmane.comp.apache.announce">news.gmane.org</a>
+ <td>
+ <a class="externalLink"
href="https://lists.apache.org/[email protected]">lists.apache.org</a>
+ </td>
+ <td>
+ <a class="externalLink"
href="https://www.mail-archive.com/[email protected]/">www.mail-archive.com</a>
</td>
</tr>
</table>