This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-daemon.git
The following commit(s) were added to refs/heads/master by this push:
new 871dd0c Re-generate generated files to pick up new templates
871dd0c is described below
commit 871dd0c9134ee56507884233899860c55211ad08
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Wed May 15 15:37:12 2024 +0100
Re-generate generated files to pick up new templates
---
CONTRIBUTING.md | 5 ++---
README.md | 45 ++++++++++++++++++++++++---------------
src/site/xdoc/download_daemon.xml | 28 ++++++++++++------------
src/site/xdoc/issue-tracking.xml | 2 +-
src/site/xdoc/mail-lists.xml | 38 ++++++++++++++++-----------------
5 files changed, 63 insertions(+), 55 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index dfb9535..3796f16 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -49,13 +49,13 @@ 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 Daemon'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
--------------
@@ -109,7 +109,6 @@ Additional Resources
+ [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/DAEMON
diff --git a/README.md b/README.md
index 7d254eb..28285b7 100644
--- a/README.md
+++ b/README.md
@@ -45,10 +45,10 @@ Apache Commons Daemon
[](https://github.com/apache/commons-daemon/actions/workflows/maven.yml)
[](https://app.codecov.io/gh/apache/commons-daemon)
-[](https://maven-badges.herokuapp.com/maven-central/commons-daemon/commons-daemon/)
-[](https://javadoc.io/doc/commons-daemon/commons-daemon/1.3.4)
-[](https://github.com/apache/commons-daemon/actions/workflows/codeql-analysis-cpp.yml)
-[](https://github.com/apache/commons-daemon/actions/workflows/codeql-analysis-java.yml)
+[](https://maven-badges.herokuapp.com/maven-central/commons-daemon/commons-daemon/?gav=true)
+[](https://javadoc.io/doc/commons-daemon/commons-daemon/1.4.0)
+[](https://github.com/apache/commons-daemon/actions/workflows/codeql-analysis.yml)
+[](https://api.securityscorecards.dev/projects/github.com/apache/commons-daemon)
Apache Commons Daemon software is a set of utilities and Java support
classes for running Java applications as server processes. These are
@@ -62,49 +62,60 @@ More information can be found on the [Apache Commons Daemon
homepage](https://co
The [Javadoc](https://commons.apache.org/proper/commons-daemon/apidocs) can be
browsed.
Questions related to the usage of Apache Commons Daemon 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-daemon/download_daemon.cgi).
-Alternatively, you can pull it from the central Maven repositories:
+Alternatively, you can pull it from the central Maven repositories:
```xml
<dependency>
<groupId>commons-daemon</groupId>
<artifactId>commons-daemon</artifactId>
- <version>1.3.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```.
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 License
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 Daemon? Then [donate back to the
ASF](https://www.apache.org/foundation/contributing.html) to support the
development.
+Donating
+--------
+You like Apache Commons Daemon? 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/DAEMON)
++ [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/src/site/xdoc/download_daemon.xml
b/src/site/xdoc/download_daemon.xml
index 2432fbc..27c2e9c 100644
--- a/src/site/xdoc/download_daemon.xml
+++ b/src/site/xdoc/download_daemon.xml
@@ -107,38 +107,38 @@ limitations under the License.
failing that using the <code>SHA512</code> hash (<code>*.sha512</code>
checksum files).
</p>
<p>
- The <a href="https://www.apache.org/dist/commons/KEYS";>KEYS</a>
+ 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="Apache Commons Daemon 1.3.4 ">
+ <section name="Apache Commons Daemon 1.4.0 ">
<subsection name="Binaries">
<table>
<tr>
- <td><a
href="[preferred]/commons/daemon/binaries/commons-daemon-1.3.4-bin.tar.gz">commons-daemon-1.3.4-bin.tar.gz</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/binaries/commons-daemon-1.3.4-bin.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/binaries/commons-daemon-1.3.4-bin.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/daemon/binaries/commons-daemon-1.4.0-bin.tar.gz">commons-daemon-1.4.0-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/binaries/commons-daemon-1.4.0-bin.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/binaries/commons-daemon-1.4.0-bin.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/daemon/binaries/commons-daemon-1.3.4-bin.zip">commons-daemon-1.3.4-bin.zip</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/binaries/commons-daemon-1.3.4-bin.zip.sha512";>sha512</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/binaries/commons-daemon-1.3.4-bin.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/daemon/binaries/commons-daemon-1.4.0-bin.zip">commons-daemon-1.4.0-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/binaries/commons-daemon-1.4.0-bin.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/binaries/commons-daemon-1.4.0-bin.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a
href="[preferred]/commons/daemon/source/commons-daemon-1.3.4-src.tar.gz">commons-daemon-1.3.4-src.tar.gz</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/source/commons-daemon-1.3.4-src.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/source/commons-daemon-1.3.4-src.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/daemon/source/commons-daemon-1.4.0-src.tar.gz">commons-daemon-1.4.0-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/source/commons-daemon-1.4.0-src.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/source/commons-daemon-1.4.0-src.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/daemon/source/commons-daemon-1.3.4-src.zip">commons-daemon-1.3.4-src.zip</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/source/commons-daemon-1.3.4-src.zip.sha512";>sha512</a></td>
- <td><a
href="https://www.apache.org/dist/commons/daemon/source/commons-daemon-1.3.4-src.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/daemon/source/commons-daemon-1.4.0-src.zip">commons-daemon-1.4.0-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/source/commons-daemon-1.4.0-src.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/daemon/source/commons-daemon-1.4.0-src.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index 9debeb8..463de37 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -85,7 +85,7 @@ limitations under the License.
</p>
<p>
- For more information on subversion and creating patches see the
+ For more information on creating patches see the
<a href="https://www.apache.org/dev/contributors.html";>Apache
Contributors Guide</a>.
</p>
diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml
index a6b6101..9992469 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -59,9 +59,9 @@ limitations under the License.
</p>
<p>
Questions related to the usage of Apache Commons Daemon should be
posted to the
- <a href="https://mail-archives.apache.org/mod_mbox/commons-user/";>User
List</a>.
+ <a
href="https://lists.apache.org/list.html?u...@commons.apache.org";>User List</a>.
<br />
- The <a
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>Developer List</a>
+ The <a
href="https://lists.apache.org/list.html?d...@commons.apache.org";>Developer
List</a>
is for questions and discussion related to the development of Apache
Commons Daemon.
<br />
Please do not cross-post; developers are also subscribed to the user
list.
@@ -70,8 +70,10 @@ limitations under the License.
to subscribe.
</p>
<p>
- <strong>Note:</strong> please don't send patches or attachments to any
of the mailing lists.
+ <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>
@@ -105,12 +107,11 @@ limitations under the License.
<td><a
href="mailto:user-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:user-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><a
href="mailto:u...@commons.apache.org?subject=[daemon]";>Post</a></td>
- <td><a
href="https://mail-archives.apache.org/mod_mbox/commons-user/";>mail-archives.apache.org</a><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?u...@commons.apache.org";>lists.apache.org</a>
</td>
- <td><a
href="https://markmail.org/list/org.apache.commons.users/";>markmail.org</a><br
/>
- <a
href="https://www.mail-archive.com/user@commons.apache.org/";>www.mail-archive.com</a><br
/>
- <a
href="https://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
+ <td>
+ <a
href="https://www.mail-archive.com/user@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -125,12 +126,11 @@ limitations under the License.
<td><a
href="mailto:dev-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:dev-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><a
href="mailto:d...@commons.apache.org?subject=[daemon]";>Post</a></td>
- <td><a
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>mail-archives.apache.org</a><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?d...@commons.apache.org";>lists.apache.org</a>
</td>
- <td><a
href="https://markmail.org/list/org.apache.commons.dev/";>markmail.org</a><br />
- <a
href="https://www.mail-archive.com/dev@commons.apache.org/";>www.mail-archive.com</a><br
/>
- <a
href="https://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
+ <td>
+ <a
href="https://www.mail-archive.com/dev@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -145,10 +145,10 @@ limitations under the License.
<td><a
href="mailto:issues-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:issues-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a
href="https://mail-archives.apache.org/mod_mbox/commons-issues/";>mail-archives.apache.org</a><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?iss...@commons.apache.org";>lists.apache.org</a>
</td>
- <td><a
href="https://markmail.org/list/org.apache.commons.issues/";>markmail.org</a><br
/>
+ <td>
<a
href="https://www.mail-archive.com/issues@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -164,10 +164,10 @@ limitations under the License.
<td><a
href="mailto:commits-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:commits-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a
href="https://mail-archives.apache.org/mod_mbox/commons-commits/";>mail-archives.apache.org</a><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?commits@commons.apache.org";>lists.apache.org</a>
</td>
- <td><a
href="https://markmail.org/list/org.apache.commons.commits/";>markmail.org</a><br
/>
+ <td>
<a
href="https://www.mail-archive.com/commits@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -199,13 +199,11 @@ limitations under the License.
<td><a class="externalLink"
href="mailto:announce-subscr...@apache.org";>Subscribe</a></td>
<td><a class="externalLink"
href="mailto:announce-unsubscr...@apache.org";>Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a class="externalLink"
href="https://mail-archives.apache.org/mod_mbox/www-announce/";>mail-archives.apache.org</a><br
/>
+ <td>
<a class="externalLink"
href="https://lists.apache.org/list.html?annou...@apache.org";>lists.apache.org</a>
</td>
- <td><a class="externalLink"
href="https://markmail.org/list/org.apache.announce/";>markmail.org</a><br />
- <a class="externalLink"
href="https://old.nabble.com/Apache-News-and-Announce-f109.html";>old.nabble.com</a><br
/>
- <a class="externalLink"
href="https://www.mail-archive.com/announce@apache.org/";>www.mail-archive.com</a><br
/>
- <a class="externalLink"
href="https://news.gmane.org/gmane.comp.apache.announce";>news.gmane.org</a>
+ <td>
+ <a class="externalLink"
href="https://www.mail-archive.com/announce@apache.org/";>www.mail-archive.com</a>
</td>
</tr>
</table>
