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-email.git
The following commit(s) were added to refs/heads/master by this push: new 9823284 Prepare for release candidate 9823284 is described below commit 9823284edf436e916e2a76016f4db098e4049f84 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Sat Mar 2 12:20:08 2024 -0500 Prepare for release candidate --- CONTRIBUTING.md | 6 +- NOTICE.txt | 10 +- README.md | 16 +- RELEASE-NOTES.txt | 217 ++++++++++++++++++--------- src/changes/changes.xml | 2 +- src/changes/release-notes.vm | 22 ++- src/site/xdoc/download_email.xml | 312 +++++++++++++++++++-------------------- src/site/xdoc/issue-tracking.xml | 204 ++++++++++++------------- src/site/xdoc/mail-lists.xml | 16 +- 9 files changed, 442 insertions(+), 363 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3f08e66..04514e3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -38,7 +38,7 @@ | | +======================================================================+ ---> -Contributing to Apache Commons Email +Contributing to Apache Commons Email Parent POM ====================== 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 @@ -50,7 +50,7 @@ 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). 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 Email's scope. ++ 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 Email Parent POM'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. @@ -104,7 +104,7 @@ Additional Resources -------------------- + [Contributing patches](https://commons.apache.org/patches.html) -+ [Apache Commons Email JIRA project page][jira] ++ [Apache Commons Email Parent POM 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/) diff --git a/NOTICE.txt b/NOTICE.txt index dfd41c3..1e0573a 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -1,5 +1,5 @@ -Apache Commons Email -Copyright 2001-2024 The Apache Software Foundation - -This product includes software developed at -The Apache Software Foundation (https://www.apache.org/). +Apache Commons Email Parent POM +Copyright 2001-2024 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (https://www.apache.org/). diff --git a/README.md b/README.md index e472d38..82041fa 100644 --- a/README.md +++ b/README.md @@ -40,13 +40,13 @@ | | +======================================================================+ ---> -Apache Commons Email +Apache Commons Email Parent POM =================== [](https://github.com/apache/commons-email/actions/workflows/maven.yml) [](https://app.codecov.io/gh/apache/commons-email) -[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-email/?gav=true) -[](https://javadoc.io/doc/org.apache.commons/commons-email/1.6.0) +[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-email2-parent/?gav=true) +[](https://javadoc.io/doc/org.apache.commons/commons-email2-parent/2.0.0-M1) [](https://github.com/apache/commons-email/actions/workflows/codeql-analysis.yml) [](https://api.securityscorecards.dev/projects/github.com/apache/commons-email) @@ -55,9 +55,9 @@ Apache Commons Email provides an API for sending email, simplifying the JavaMail Documentation ------------- -More information can be found on the [Apache Commons Email homepage](https://commons.apache.org/proper/commons-email). +More information can be found on the [Apache Commons Email Parent POM homepage](https://commons.apache.org/proper/commons-email). The [Javadoc](https://commons.apache.org/proper/commons-email/apidocs) can be browsed. -Questions related to the usage of Apache Commons Email should be posted to the [user mailing list](https://commons.apache.org/mail-lists.html). +Questions related to the usage of Apache Commons Email Parent POM should be posted to the [user mailing list](https://commons.apache.org/mail-lists.html). Getting the latest release -------------------------- @@ -68,8 +68,8 @@ Alternatively, you can pull it from the central Maven repositories: ```xml <dependency> <groupId>org.apache.commons</groupId> - <artifactId>commons-email</artifactId> - <version>1.6.0</version> + <artifactId>commons-email2-parent</artifactId> + <version>2.0.0-M1</version> </dependency> ``` @@ -102,7 +102,7 @@ See the `NOTICE.txt` file for required notices and attributions. Donating -------- -You like Apache Commons Email? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support development. +You like Apache Commons Email Parent POM? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support development. Additional Resources -------------------- diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index bcb46b3..f467127 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,3 +1,49 @@ +Apache Commons Email Parent POM 2.0.0-M1-SNAPSHOT +RELEASE NOTES + +The Apache Commons Email Parent POM team is pleased to announce the release of Apache Commons Email Parent POM 2.0.0-M1-SNAPSHOT. + +Apache Commons Email provides an API for sending email, simplifying the JavaMail API. + + +Feature release (Java 8 or above). + +For complete information on Apache Commons Email Parent POM, including instructions on how to submit bug reports, +patches, or suggestions for improvement, see the Apache Commons Email Parent POM website: + +https://commons.apache.org/proper/commons-email/ + +Download page: https://commons.apache.org/proper/commons-email/download_net.cgi + +Changes in this version +---------------------- + +New features +------------ + +* Add Maven property project.build.outputTimestamp for build reproducibility. Thanks to Gary Gregory. + +Fixed Bugs +---------- + +* Fix Checkstyle configuration. Thanks to Gary Gregory. + +Changes +------- + +* Bump org.slf4j:slf4j-jdk14 from 2.0.9 to 2.0.12. Thanks to Dependabot. +* Bump com.github.davidmoten:subethasmtp from 6.0.7 to 7.0.1. Thanks to Dependabot. +* Bump org.mockito:mockito-core from 5.8.0 to 5.10.0. Thanks to Dependabot. +* Bump commons-parent from 65 to 66. Thanks to Gary Gregory. + + +Historical list of changes: https://commons.apache.org/proper/commons-email/changes-report.html + +Enjoy! +-Apache Commons Net team + +------------------------------------------------------------------------ + Apache Commons Email 1.6.0 RELEASE NOTES @@ -18,59 +64,65 @@ Download page: https://commons.apache.org/proper/commons-email/download_net.cgi Changes in this version include: =============================== -New features: -o Add github/codeql-action #75. Thanks to Dependabot. -o Add Maven plugin JapiCmp and remove Clirr. Thanks to Gary Gregory. +New features +------------ + +* Add github/codeql-action #75. Thanks to Dependabot. +* Add Maven plugin JapiCmp and remove Clirr. Thanks to Gary Gregory. o EMAIL-176: Add Automatic-Module-Name MANIFEST entry for Java 9 compatibility. o EMAIL-207: Add InputStreamDataSource. Thanks to Lee Jaeheon, Gary Gregory. o EMAIL-207: Don't waste memory in MimeMessageParser#createDataSource(). Thanks to Lee Jaeheon, Gary Gregory. -o Add EmailConstants.SOCKET_TIMEOUT and deprecate SOCKET_TIMEOUT_MS. Thanks to Gary Gregory. -o Add Email.setSocketConnectionTimeout(Duration) and deprecate setSocketConnectionTimeout(int). Thanks to Gary Gregory. -o Add Email.setSocketTimeout(Duration) and deprecate setSocketTimeout(int). Thanks to Gary Gregory. -o Add PathDataSource. Thanks to Gary Gregory. -o Add DataSourcePathResolver. Thanks to Gary Gregory. -o Add MimeMessageUtils.createMimeMessage(Session, Path, OpenOption...). Thanks to Gary Gregory. -o Add MultiPartEmail.attach(Path, OpenOption...). Thanks to Gary Gregory. - -Fixed Bugs: +* Add EmailConstants.SOCKET_TIMEOUT and deprecate SOCKET_TIMEOUT_MS. Thanks to Gary Gregory. +* Add Email.setSocketConnectionTimeout(Duration) and deprecate setSocketConnectionTimeout(int). Thanks to Gary Gregory. +* Add Email.setSocketTimeout(Duration) and deprecate setSocketTimeout(int). Thanks to Gary Gregory. +* Add PathDataSource. Thanks to Gary Gregory. +* Add DataSourcePathResolver. Thanks to Gary Gregory. +* Add MimeMessageUtils.createMimeMessage(Session, Path, OpenOption...). Thanks to Gary Gregory. +* Add MultiPartEmail.attach(Path, OpenOption...). Thanks to Gary Gregory. + +Fixed Bugs +---------- + o EMAIL-190: Fix broken JDK 9 build by updating "easymock" and other dependencies. Thanks to sgoeschl. -o Use JUnit 5 APIs #106, #108, #109, #114. Thanks to John Patrick, Gary Gregory. -o [StepSecurity] ci: Harden GitHub Actions #149. Thanks to step-security-bot, Gary Gregory. -o Better use of JUnit APIs #158. Thanks to Lee Jaeheon, sebbASF. +* Use JUnit 5 APIs #106, #108, #109, #114. Thanks to John Patrick, Gary Gregory. +* [StepSecurity] ci: Harden GitHub Actions #149. Thanks to step-security-bot, Gary Gregory. +* Better use of JUnit APIs #158. Thanks to Lee Jaeheon, sebbASF. o EMAIL-205: Update conversion code #153. Thanks to Dimitrios Efthymiou, Alex Herbert. -o Email.setBounceAddress no longer accepts invalid email addresses. Thanks to Alexander Lehmann. -o Throw more specific exceptions in MimeMessageParser #11. Thanks to Amir Behnam, Michael Osipov. -o Email.setMailSession(Session) throws the more precise exception NullPointerException. Thanks to Gary Gregory. -o Avoid possible NullPointerException in DataSourceClassPathResolver.resolve(String, boolean). Thanks to Gary Gregory. -o Complete half-baked test DataSourceUrlResolverTest.testResolvingHttpNonLenient(). Thanks to Gary Gregory. +* Email.setBounceAddress no longer accepts invalid email addresses. Thanks to Alexander Lehmann. +* Throw more specific exceptions in MimeMessageParser #11. Thanks to Amir Behnam, Michael Osipov. +* Email.setMailSession(Session) throws the more precise exception NullPointerException. Thanks to Gary Gregory. +* Avoid possible NullPointerException in DataSourceClassPathResolver.resolve(String, boolean). Thanks to Gary Gregory. +* Complete half-baked test DataSourceUrlResolverTest.testResolvingHttpNonLenient(). Thanks to Gary Gregory. o EMAIL-206: Use SharedByteArrayInputStream for memory usage #157. Thanks to Lee Jaeheon, Gary Gregory. -o Migrate to JUnit 5 #186. Thanks to Loki-Afro, Gary Gregory. +* Migrate to JUnit 5 #186. Thanks to Loki-Afro, Gary Gregory. o EMAIL-174: Bump javax.mail dependency to 1.6.1, so that i18n is supported for email addresses. Thanks to Vegard Stuen. -o Add missing getters and setters in EMail and subclasses; deprecate access to protected instance variables. Thanks to Loki-Afro, Gary Gregory. -o DataSourceUrlResolver.resolve(String, boolean) leaks InputStreams. Thanks to Gary Gregory. -o Use US-ASCII in MimeMessageUtils.createMimeMessage(Session, String). Thanks to Gary Gregory. - -Changes: -o Bump org.slf4j:slf4j-jdk14 from 1.7.7 to 2.0.9 #165. Thanks to Dependabot. -o Bump mockito-core from 4.11.0 to 5.8.0 #187. Thanks to Dependabot. -o Bump actions/cache from 2 to 3.0.11 #39, #48, #60, #70, #102. Thanks to Dependabot, Gary Gregory. -o Bump actions/checkout from 1 to 3.2.0, #25 #33, #67, #99, #117. Thanks to Dependabot, Gary Gregory. -o Bump actions/setup-java from 1.4.0 to v3.6.0 #30, #74, #103. Thanks to Dependabot, Gary Gregory. -o Bump actions/upload-artifact from 3.1.0 to 3.1.1 #110. Thanks to Dependabot. +* Add missing getters and setters in EMail and subclasses; deprecate access to protected instance variables. Thanks to Loki-Afro, Gary Gregory. +* DataSourceUrlResolver.resolve(String, boolean) leaks InputStreams. Thanks to Gary Gregory. +* Use US-ASCII in MimeMessageUtils.createMimeMessage(Session, String). Thanks to Gary Gregory. + +Changes +------- + +* Bump org.slf4j:slf4j-jdk14 from 1.7.7 to 2.0.9 #165. Thanks to Dependabot. +* Bump mockito-core from 4.11.0 to 5.8.0 #187. Thanks to Dependabot. +* Bump actions/cache from 2 to 3.0.11 #39, #48, #60, #70, #102. Thanks to Dependabot, Gary Gregory. +* Bump actions/checkout from 1 to 3.2.0, #25 #33, #67, #99, #117. Thanks to Dependabot, Gary Gregory. +* Bump actions/setup-java from 1.4.0 to v3.6.0 #30, #74, #103. Thanks to Dependabot, Gary Gregory. +* Bump actions/upload-artifact from 3.1.0 to 3.1.1 #110. Thanks to Dependabot. o EMAIL-177: Bump from Java 6 to 7. Thanks to Gary Gregory. -o Bump from Java 7 to 8. Thanks to Gary Gregory. +* Bump from Java 7 to 8. Thanks to Gary Gregory. o EMAIL-183: Bump javax.mail:1.6.1 to jakarta.mail:1.6.7. Thanks to Lukas Petrovicky, gitmotte, Dependabot, Gary Gregory. -o Bump commons-parent from 50 to 65, #118, #128. Thanks to Gary Gregory, Dependabot. -o Bump spotbugs-maven-plugin from 4.0.0 to 4.7.2 #18. Thanks to Dependabot, Gary Gregory. -o Bump spotbugs from 4.0.6 to 4.7.2 #40. Thanks to Dependabot. -o Bump junit from 4.13 to 4.13.2 #32. Thanks to Dependabot, Gary Gregory. -o Bump commons-release-plugin from 1.0 to 1.7 #23. Thanks to Dependabot. -o Bump maven-pmd-plugin from 3.13.0 to 3.19.0 #34, #72, #79, #94. Thanks to Dependabot. -o Bump tests commons-io:commons-io 2.6 to 2.15.1. Thanks to Gary Gregory. -o Bump jacoco from 0.8.6 to 0.8.8; fixes jacoco on Java 17. Thanks to Gary Gregory. -o Bump org.easymock:easymock from 4.2 to 5.2.0, #107, #164. Thanks to Gary Gregory. -o Bump commons-release-plugin from 1.7 to 1.8.1 #73, #184. Thanks to Dependabot. -o Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #87. Thanks to Dependabot. +* Bump commons-parent from 50 to 65, #118, #128. Thanks to Gary Gregory, Dependabot. +* Bump spotbugs-maven-plugin from 4.0.0 to 4.7.2 #18. Thanks to Dependabot, Gary Gregory. +* Bump spotbugs from 4.0.6 to 4.7.2 #40. Thanks to Dependabot. +* Bump junit from 4.13 to 4.13.2 #32. Thanks to Dependabot, Gary Gregory. +* Bump commons-release-plugin from 1.0 to 1.7 #23. Thanks to Dependabot. +* Bump maven-pmd-plugin from 3.13.0 to 3.19.0 #34, #72, #79, #94. Thanks to Dependabot. +* Bump tests commons-io:commons-io 2.6 to 2.15.1. Thanks to Gary Gregory. +* Bump jacoco from 0.8.6 to 0.8.8; fixes jacoco on Java 17. Thanks to Gary Gregory. +* Bump org.easymock:easymock from 4.2 to 5.2.0, #107, #164. Thanks to Gary Gregory. +* Bump commons-release-plugin from 1.7 to 1.8.1 #73, #184. Thanks to Dependabot. +* Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #87. Thanks to Dependabot. Historical list of changes: https://commons.apache.org/proper/commons-email/changes-report.html @@ -78,14 +130,14 @@ Historical list of changes: https://commons.apache.org/proper/commons-email/chan Enjoy! -Apache Commons Net team ------------------------------------------------------------------------------ +------------------------------------------------------------------------ Commons Email Package Version 1.5 Release Notes -INTRODUCTION: -------------- +INTRODUCTION +------------ Commons Email aims to provide a API for sending email. It builds on the JavaMail API with the aim of presenting a simplified API which is easy for developers who @@ -100,10 +152,11 @@ http://commons.apache.org/email/ This is a major release which adds some new features and fixes several bugs present in the 1.4.0 release. All current users are encouraged to upgrade. -CHANGES FROM 1.4: ------------------ +CHANGES FROM 1.4 +---------------- -== Compatibility == +Compatibility +------------- * Java 6 or later is required. @@ -116,7 +169,8 @@ CHANGES FROM 1.4: <version>1.5.6</version> </dependency> -== New Features == +New Features +------------ * Add Support for International Domain Names. This change requires JDK 1.6+. Issue: EMAIL-160 @@ -124,7 +178,8 @@ Issue: EMAIL-160 * Add Email#getHeader(String) and Email#getHeaders() methods. Issue: EMAIL-154. Thanks to Ken Geis, Balachandran Sivakumar -== Updates == +Updates +------- * Update Oracle JavaMail dependency from 1.5.2 to 1.5.6. Issue: EMAIL-165. @@ -132,15 +187,17 @@ Issue: EMAIL-154. Thanks to Ken Geis, Balachandran Sivakumar * Remove "javax.activation" dependency since it is included in JDK 1.6 Issue: EMAIL-161. -== Fixed Bugs == +Fixed Bugs +---------- * DataSourceClassPathResolver doesn't close InputStream when resolving resources Issue: EMAIL-167. Thanks to Lucian Burja. -CHANGES FROM 1.3.3: ------------------ +CHANGES FROM 1.3.3 +------------------ -== Compatibility == +Compatibility +------------- * Java 5 or later is required (unchanged since 1.3). @@ -166,7 +223,9 @@ CHANGES FROM 1.3.3: * Update Oracle JavaMail dependency from 1.4.5 to 1.5.2. Issue: EMAIL-144. -== Fixed Bugs == +Fixed Bugs +---------- + * "Email" threw an "EmailException" when trying to send the email if neither a from nor bounce address was specified, although a "mail.from" property was set in the mail session. @@ -184,14 +243,17 @@ CHANGES FROM 1.3.3: Issue: EMAIL-142. Thanks to Marcin Tomiak. -CHANGES FROM 1.3.2: ------------------ +CHANGES FROM 1.3.2 +------------------ -== Compatibility == +Compatibility +------------- * Java 5 or later is required (unchanged since 1.3). -== Fixed Bugs == +Fixed Bugs +---------- + * The filename of an attachment was not properly encoded in case it contained non-ascii characters. @@ -205,14 +267,17 @@ CHANGES FROM 1.3.2: Issue: EMAIL-136. Thanks to Ville Skyttä. -CHANGES FROM 1.3.1: ------------------ +CHANGES FROM 1.3.1 +------------------ -== Compatibility == +Compatibility +------------- * Java 5 or later is required (unchanged since 1.3). -== Fixed Bugs == +Fixed Bugs +---------- + * Change visibility of DataSourceUrlResourceResolver.createUrl(String) to protected so that sub-classes can override it. @@ -235,14 +300,17 @@ CHANGES FROM 1.3.1: Issue: EMAIL-127. Thanks to Dominik Stadler. -CHANGES FROM 1.3: ------------------ +CHANGES FROM 1.3 +---------------- -== Compatibility == +Compatibility +------------- * Java 5 or later is required (unchanged since 1.3). -== Fixed Bugs == +Fixed Bugs +---------- + * DataSourceClassPathResolver will now correctly set the DataSource name for resolved resources. Additionally, it is now possible to set the name for a ByteArrayDataSource. @@ -253,10 +321,11 @@ CHANGES FROM 1.3: Issue: EMAIL-124. Thanks to Stefan Schueffler. -CHANGES FROM 1.2: ------------------ +CHANGES FROM 1.2 +---------------- -== Compatibility == +Compatibility +------------- * Java 5 or later is now required. @@ -272,7 +341,9 @@ CHANGES FROM 1.2: * Added MimeMessageParser and MimeMessageUtils. -== Fixed Bugs == +Fixed Bugs +---------- + * Use the provided Content-ID in HtmlEmail#embed(File, String) instead of creating a random one. The used and returned Content-ID will be URL encoded (see RFC 2392). diff --git a/src/changes/changes.xml b/src/changes/changes.xml index 3e2d519..dafe09b 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -23,7 +23,7 @@ </properties> <body> - <release version="2.0.0-M1" date="202Y-MM-DD" description="Feature release (Java 8 or above)."> + <release version="2.0.0-M1" date="2024-03-02" description="Feature release (Java 8 or above)."> <!-- ADD --> <action dev="ggregory" type="add" due-to="Gary Gregory">Add Maven property project.build.outputTimestamp for build reproducibility.</action> <!-- FIX --> diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm index c8bd1d0..5b2c7e1 100644 --- a/src/changes/release-notes.vm +++ b/src/changes/release-notes.vm @@ -77,7 +77,7 @@ $action #else #set($dueto="") #end -o $issue ${action}$dueto +* $issue ${action}$dueto #end #set($action="") #set($issue="") @@ -87,11 +87,13 @@ o $issue ${action}$dueto #if ($release.getActions().size() == 0) No changes defined in this version. #else -Changes in this version include: -=============================== +Changes in this version +----------------------- #if ($release.getActions('add').size() !=0) -New features: +New features +------------ + #foreach($actionItem in $release.getActions('add')) #processaction() #end @@ -99,7 +101,9 @@ New features: #end ## #if ($release.getActions('fix').size() !=0) -Fixed Bugs: +Fixed Bugs +---------- + #foreach($actionItem in $release.getActions('fix')) #processaction() #end @@ -107,7 +111,9 @@ Fixed Bugs: #end ## #if ($release.getActions('update').size() !=0) -Changes: +Changes +------- + #foreach($actionItem in $release.getActions('update')) #processaction() #end @@ -115,7 +121,9 @@ Changes: #end ## #if ($release.getActions('remove').size() !=0) -Removed: +Removed +------- + #foreach($actionItem in $release.getActions('remove')) #processaction() #end diff --git a/src/site/xdoc/download_email.xml b/src/site/xdoc/download_email.xml index 04a18dc..42d7d9f 100644 --- a/src/site/xdoc/download_email.xml +++ b/src/site/xdoc/download_email.xml @@ -1,156 +1,156 @@ -<?xml version="1.0"?> -<!-- -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. ---> -<!-- - +======================================================================+ - |**** ****| - |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| - |**** DO NOT EDIT DIRECTLY ****| - |**** ****| - +======================================================================+ - | TEMPLATE FILE: download-page-template.xml | - | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | - +======================================================================+ - | | - | 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.release.version (required) | - | - 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> | - | <commons.release.version>1.2</commons.release.version> | - | </properties> | - | | - +======================================================================+ ---> -<document> - <properties> - <title>Download Apache Commons Email</title> - <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> - </properties> - <body> - <section name="Download Apache Commons Email"> - <subsection name="Using a Mirror"> - <p> - We recommend you use a mirror to download our release - 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 all the mirrors. - </p> - - <p> - You are currently using <b>[preferred]</b>. If you - encounter a problem with this mirror, please select another - mirror. If all mirrors are failing, there are <i>backup</i> - 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] - </p> - - <form action="[location]" method="get" id="SelectMirror"> - <p> - Other mirrors: - <select name="Preferred"> - [if-any http] - [for http]<option value="[http]">[http]</option>[end] - [end] - [if-any ftp] - [for ftp]<option value="[ftp]">[ftp]</option>[end] - [end] - [if-any backup] - [for backup]<option value="[backup]">[backup] (backup)</option>[end] - [end] - </select> - <input type="submit" value="Change"></input> - </p> - </form> - - <p> - 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="Apache Commons Email 1.6.0 (Java 8 or above)"> - <subsection name="Binaries"> - <table> - <tr> - <td><a href="[preferred]/commons/email/binaries/commons-email-1.6.0-bin.tar.gz">commons-email-1.6.0-bin.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email-1.6.0-bin.tar.gz.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email-1.6.0-bin.tar.gz.asc">pgp</a></td> - </tr> - <tr> - <td><a href="[preferred]/commons/email/binaries/commons-email-1.6.0-bin.zip">commons-email-1.6.0-bin.zip</a></td> - <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email-1.6.0-bin.zip.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email-1.6.0-bin.zip.asc">pgp</a></td> - </tr> - </table> - </subsection> - <subsection name="Source"> - <table> - <tr> - <td><a href="[preferred]/commons/email/source/commons-email-1.6.0-src.tar.gz">commons-email-1.6.0-src.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/email/source/commons-email-1.6.0-src.tar.gz.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/email/source/commons-email-1.6.0-src.tar.gz.asc">pgp</a></td> - </tr> - <tr> - <td><a href="[preferred]/commons/email/source/commons-email-1.6.0-src.zip">commons-email-1.6.0-src.zip</a></td> - <td><a href="https://downloads.apache.org/commons/email/source/commons-email-1.6.0-src.zip.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/email/source/commons-email-1.6.0-src.zip.asc">pgp</a></td> - </tr> - </table> - </subsection> - </section> - <section name="Archives"> - <p> - Older releases can be obtained from the archives. - </p> - <ul> - <li class="download"><a href="[preferred]/commons/email/">browse download area</a></li> - <li><a href="https://archive.apache.org/dist/commons/email/">archives...</a></li> - </ul> - </section> - </body> -</document> +<?xml version="1.0"?> +<!-- +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. +--> +<!-- + +======================================================================+ + |**** ****| + |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| + |**** DO NOT EDIT DIRECTLY ****| + |**** ****| + +======================================================================+ + | TEMPLATE FILE: download-page-template.xml | + | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | + +======================================================================+ + | | + | 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.release.version (required) | + | - 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> | + | <commons.release.version>1.2</commons.release.version> | + | </properties> | + | | + +======================================================================+ +--> +<document> + <properties> + <title>Download Apache Commons Email Parent POM</title> + <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> + </properties> + <body> + <section name="Download Apache Commons Email Parent POM"> + <subsection name="Using a Mirror"> + <p> + We recommend you use a mirror to download our release + 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 all the mirrors. + </p> + + <p> + You are currently using <b>[preferred]</b>. If you + encounter a problem with this mirror, please select another + mirror. If all mirrors are failing, there are <i>backup</i> + 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] + </p> + + <form action="[location]" method="get" id="SelectMirror"> + <p> + Other mirrors: + <select name="Preferred"> + [if-any http] + [for http]<option value="[http]">[http]</option>[end] + [end] + [if-any ftp] + [for ftp]<option value="[ftp]">[ftp]</option>[end] + [end] + [if-any backup] + [for backup]<option value="[backup]">[backup] (backup)</option>[end] + [end] + </select> + <input type="submit" value="Change"></input> + </p> + </form> + + <p> + 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="Apache Commons Email Parent POM 2.0.0-M1 (Java 8 or above)"> + <subsection name="Binaries"> + <table> + <tr> + <td><a href="[preferred]/commons/email/binaries/commons-email2-parent-2.0.0-M1-bin.tar.gz">commons-email2-parent-2.0.0-M1-bin.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email2-parent-2.0.0-M1-bin.tar.gz.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email2-parent-2.0.0-M1-bin.tar.gz.asc">pgp</a></td> + </tr> + <tr> + <td><a href="[preferred]/commons/email/binaries/commons-email2-parent-2.0.0-M1-bin.zip">commons-email2-parent-2.0.0-M1-bin.zip</a></td> + <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email2-parent-2.0.0-M1-bin.zip.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/email/binaries/commons-email2-parent-2.0.0-M1-bin.zip.asc">pgp</a></td> + </tr> + </table> + </subsection> + <subsection name="Source"> + <table> + <tr> + <td><a href="[preferred]/commons/email/source/commons-email2-parent-2.0.0-M1-src.tar.gz">commons-email2-parent-2.0.0-M1-src.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/email/source/commons-email2-parent-2.0.0-M1-src.tar.gz.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/email/source/commons-email2-parent-2.0.0-M1-src.tar.gz.asc">pgp</a></td> + </tr> + <tr> + <td><a href="[preferred]/commons/email/source/commons-email2-parent-2.0.0-M1-src.zip">commons-email2-parent-2.0.0-M1-src.zip</a></td> + <td><a href="https://downloads.apache.org/commons/email/source/commons-email2-parent-2.0.0-M1-src.zip.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/email/source/commons-email2-parent-2.0.0-M1-src.zip.asc">pgp</a></td> + </tr> + </table> + </subsection> + </section> + <section name="Archives"> + <p> + Older releases can be obtained from the archives. + </p> + <ul> + <li class="download"><a href="[preferred]/commons/email/">browse download area</a></li> + <li><a href="https://archive.apache.org/dist/commons/email/">archives...</a></li> + </ul> + </section> + </body> +</document> diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml index 9580ecf..0e8ed93 100644 --- a/src/site/xdoc/issue-tracking.xml +++ b/src/site/xdoc/issue-tracking.xml @@ -1,102 +1,102 @@ -<?xml version="1.0"?> -<!-- -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. ---> -<!-- - +======================================================================+ - |**** ****| - |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| - |**** DO NOT EDIT DIRECTLY ****| - |**** ****| - +======================================================================+ - | TEMPLATE FILE: issue-tracking-template.xml | - | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | - +======================================================================+ - | | - | 1) Re-generate using: mvn commons-build:jira-page | - | | - | 2) Set the following properties in the component's pom: | - | - commons.jira.id (required, alphabetic, upper case) | - | - commons.jira.pid (required, numeric) | - | | - | 3) Example Properties | - | | - | <properties> | - | <commons.jira.id>MATH</commons.jira.id> | - | <commons.jira.pid>12310485</commons.jira.pid> | - | </properties> | - | | - +======================================================================+ ---> -<document> - <properties> - <title>Apache Commons Email Issue tracking</title> - <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> - </properties> - <body> - - <section name="Apache Commons Email Issue tracking"> - <p> - Apache Commons Email uses <a href="https://issues.apache.org/jira/">ASF JIRA</a> for tracking issues. - See the <a href="https://issues.apache.org/jira/browse/EMAIL">Apache Commons Email JIRA project page</a>. - </p> - - <p> - To use JIRA you may need to <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a> - (if you have previously created/updated Commons issues using Bugzilla an account will have been automatically - created and you can use the <a href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a> - page to get a new password). - </p> - - <p> - If you would like to report a bug, or raise an enhancement request with - Apache Commons Email please do the following: - <ol> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&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> - <li><a href="mail-lists.html">Search the mailing list archive(s)</a>. - You may find your issue or idea has already been discussed.</li> - <li>Decide if your issue is a bug or an enhancement.</li> - <li>Submit either a <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310474&issuetype=1&priority=4&assignee=-1">bug report</a> - or <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310474&issuetype=4&priority=4&assignee=-1">enhancement request</a>.</li> - </ol> - </p> - - <p> - Please also remember these points: - <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 Email are all unpaid volunteers</li> - </ul> - </p> - - <p> - For more information on creating patches see the - <a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>. - </p> - - <p> - You may also find these links useful: - <ul> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">All Open Apache Commons Email bugs</a></li> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&sorter/field=issuekey&sorter/order=DESC&status=5&status=6">All Resolved Apache Commons Email bugs</a></li> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&sorter/field=issuekey&sorter/order=DESC">All Apache Commons Email bugs</a></li> - </ul> - </p> - </section> - </body> -</document> +<?xml version="1.0"?> +<!-- +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. +--> +<!-- + +======================================================================+ + |**** ****| + |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| + |**** DO NOT EDIT DIRECTLY ****| + |**** ****| + +======================================================================+ + | TEMPLATE FILE: issue-tracking-template.xml | + | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | + +======================================================================+ + | | + | 1) Re-generate using: mvn commons-build:jira-page | + | | + | 2) Set the following properties in the component's pom: | + | - commons.jira.id (required, alphabetic, upper case) | + | - commons.jira.pid (required, numeric) | + | | + | 3) Example Properties | + | | + | <properties> | + | <commons.jira.id>MATH</commons.jira.id> | + | <commons.jira.pid>12310485</commons.jira.pid> | + | </properties> | + | | + +======================================================================+ +--> +<document> + <properties> + <title>Apache Commons Email Parent POM Issue tracking</title> + <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> + </properties> + <body> + + <section name="Apache Commons Email Parent POM Issue tracking"> + <p> + Apache Commons Email Parent POM uses <a href="https://issues.apache.org/jira/">ASF JIRA</a> for tracking issues. + See the <a href="https://issues.apache.org/jira/browse/EMAIL">Apache Commons Email Parent POM JIRA project page</a>. + </p> + + <p> + To use JIRA you may need to <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a> + (if you have previously created/updated Commons issues using Bugzilla an account will have been automatically + created and you can use the <a href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a> + page to get a new password). + </p> + + <p> + If you would like to report a bug, or raise an enhancement request with + Apache Commons Email Parent POM please do the following: + <ol> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&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> + <li><a href="mail-lists.html">Search the mailing list archive(s)</a>. + You may find your issue or idea has already been discussed.</li> + <li>Decide if your issue is a bug or an enhancement.</li> + <li>Submit either a <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310474&issuetype=1&priority=4&assignee=-1">bug report</a> + or <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310474&issuetype=4&priority=4&assignee=-1">enhancement request</a>.</li> + </ol> + </p> + + <p> + Please also remember these points: + <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 Email Parent POM are all unpaid volunteers</li> + </ul> + </p> + + <p> + For more information on creating patches see the + <a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>. + </p> + + <p> + You may also find these links useful: + <ul> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">All Open Apache Commons Email Parent POM bugs</a></li> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&sorter/field=issuekey&sorter/order=DESC&status=5&status=6">All Resolved Apache Commons Email Parent POM bugs</a></li> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310474&sorter/field=issuekey&sorter/order=DESC">All Apache Commons Email Parent POM 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 5a73f68..ebdd8af 100644 --- a/src/site/xdoc/mail-lists.xml +++ b/src/site/xdoc/mail-lists.xml @@ -41,14 +41,14 @@ limitations under the License. --> <document> <properties> - <title>Apache Commons Email Mailing Lists</title> + <title>Apache Commons Email Parent POM Mailing Lists</title> <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> </properties> <body> <section name="Overview"> <p> - <a href="index.html">Apache Commons Email</a> shares mailing lists with all the other + <a href="index.html">Apache Commons Email Parent POM</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, @@ -58,11 +58,11 @@ limitations under the License. </ul> </p> <p> - Questions related to the usage of Apache Commons Email should be posted to the + Questions related to the usage of Apache Commons Email Parent POM should be posted to the <a href="https://lists.apache.org/list.html?u...@commons.apache.org">User List</a>. <br /> 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 Email. + is for questions and discussion related to the development of Apache Commons Email Parent POM. <br /> Please do not cross-post; developers are also subscribed to the user list. <br /> @@ -78,9 +78,9 @@ limitations under the License. </p> </section> - <section name="Apache Commons Email Mailing Lists"> + <section name="Apache Commons Email Parent POM Mailing Lists"> <p> - <strong>Please prefix the subject line of any messages for <a href="index.html">Apache Commons Email</a> + <strong>Please prefix the subject line of any messages for <a href="index.html">Apache Commons Email Parent POM</a> with <i>[email]</i></strong> - <i>thanks!</i> <br /> <br /> @@ -101,7 +101,7 @@ limitations under the License. <td> <strong>Commons User List</strong> <br /><br /> - Questions on using Apache Commons Email. + Questions on using Apache Commons Email Parent POM. <br /><br /> </td> <td><a href="mailto:user-subscr...@commons.apache.org">Subscribe</a></td> @@ -120,7 +120,7 @@ limitations under the License. <td> <strong>Commons Developer List</strong> <br /><br /> - Discussion of development of Apache Commons Email. + Discussion of development of Apache Commons Email Parent POM. <br /><br /> </td> <td><a href="mailto:dev-subscr...@commons.apache.org">Subscribe</a></td>