This is an automated email from the ASF dual-hosted git repository.
garydgregory 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 ed5351b4 Javadoc
ed5351b4 is described below
commit ed5351b40c3c4afe692d746cb37b266e5c03a0c3
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 11:22:07 2026 -0400
Javadoc
---
.../apache/commons/mail2/core/EmailException.java | 28 +++++++++----------
.../org/apache/commons/mail2/core/EmailUtils.java | 32 +++++++++++-----------
.../commons/mail2/jakarta/DataSourceResolver.java | 4 +--
.../org/apache/commons/mail2/jakarta/Email.java | 24 ++++++++--------
.../apache/commons/mail2/jakarta/HtmlEmail.java | 20 +++++++-------
.../commons/mail2/jakarta/ImageHtmlEmail.java | 6 ++--
.../commons/mail2/jakarta/MultiPartEmail.java | 4 +--
.../mail2/jakarta/activation/PathDataSource.java | 6 ++--
.../jakarta/resolver/DataSourceBaseResolver.java | 6 ++--
.../resolver/DataSourceClassPathResolver.java | 6 ++--
.../resolver/DataSourceCompositeResolver.java | 4 +--
.../jakarta/resolver/DataSourceFileResolver.java | 4 +--
.../jakarta/resolver/DataSourcePathResolver.java | 4 +--
.../jakarta/resolver/DataSourceUrlResolver.java | 6 ++--
.../mail2/jakarta/util/MimeMessageParser.java | 26 +++++++++---------
.../mail2/jakarta/util/MimeMessageUtils.java | 24 ++++++++--------
.../commons/mail2/jakarta/AbstractEmailTest.java | 6 ++--
.../commons/mail2/jakarta/EmailLiveTest.java | 2 +-
.../commons/mail2/javax/DataSourceResolver.java | 4 +--
.../java/org/apache/commons/mail2/javax/Email.java | 24 ++++++++--------
.../org/apache/commons/mail2/javax/HtmlEmail.java | 20 +++++++-------
.../apache/commons/mail2/javax/ImageHtmlEmail.java | 6 ++--
.../apache/commons/mail2/javax/MultiPartEmail.java | 4 +--
.../mail2/javax/activation/PathDataSource.java | 6 ++--
.../javax/resolver/DataSourceBaseResolver.java | 6 ++--
.../resolver/DataSourceClassPathResolver.java | 6 ++--
.../resolver/DataSourceCompositeResolver.java | 4 +--
.../javax/resolver/DataSourceFileResolver.java | 4 +--
.../javax/resolver/DataSourcePathResolver.java | 4 +--
.../javax/resolver/DataSourceUrlResolver.java | 6 ++--
.../mail2/javax/util/MimeMessageParser.java | 26 +++++++++---------
.../commons/mail2/javax/util/MimeMessageUtils.java | 24 ++++++++--------
.../commons/mail2/javax/AbstractEmailTest.java | 6 ++--
.../apache/commons/mail2/javax/EmailLiveTest.java | 2 +-
34 files changed, 182 insertions(+), 182 deletions(-)
diff --git
a/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailException.java
b/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailException.java
index 8dfbc95c..56cd2955 100644
---
a/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailException.java
+++
b/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailException.java
@@ -40,8 +40,8 @@ public class EmailException extends Exception {
*
* @param <T> the subject type to return if we don't throw.
* @param test test condition.
- * @param subject the subject to return if we don't throw.
- * @param message the exception message.
+ * @param subject The subject to return if we don't throw.
+ * @param message The exception message.
* @return The given subject.
* @throws EmailException if the supplier evaluates to true.
*/
@@ -56,8 +56,8 @@ public class EmailException extends Exception {
* Throws an EmailException if the collection is empty.
*
* @param <T> the type of elements in the collection.
- * @param value the value to test.
- * @param message the exception message.
+ * @param value The value to test.
+ * @param message The exception message.
* @return The given subject.
* @throws EmailException if the collection is empty.
*/
@@ -68,8 +68,8 @@ public class EmailException extends Exception {
/**
* Throws an EmailException if the string is empty.
*
- * @param message the exception message.
- * @param value the value to test.
+ * @param message The exception message.
+ * @param value The value to test.
* @return The given subject.
* @throws EmailException if the string is empty.
*/
@@ -81,8 +81,8 @@ public class EmailException extends Exception {
* Throws an EmailException if the array is empty.
*
* @param <T> the array type.
- * @param message the exception message.
- * @param value the value to test.
+ * @param message The exception message.
+ * @param value The value to test.
* @return The given subject.
* @throws EmailException if the array is empty.
*/
@@ -94,8 +94,8 @@ public class EmailException extends Exception {
* Throws an EmailException if the value is null.
*
* @param <T> the value type.
- * @param message the exception message.
- * @param value the value to test.
+ * @param message The exception message.
+ * @param value The value to test.
* @return The given subject.
* @throws EmailException if the value is null.
*/
@@ -115,7 +115,7 @@ public class EmailException extends Exception {
/**
* Constructs a new {@code EmailException} with specified detail message.
*
- * @param msg the error message.
+ * @param msg The error message.
*/
public EmailException(final String msg) {
super(msg);
@@ -124,8 +124,8 @@ public class EmailException extends Exception {
/**
* Constructs a new {@code EmailException} with specified detail message
and nested {@code Throwable} root cause.
*
- * @param msg the error message.
- * @param rootCause the exception or error that caused this exception to
be thrown.
+ * @param msg The error message.
+ * @param rootCause The exception or error that caused this exception to
be thrown.
*/
public EmailException(final String msg, final Throwable rootCause) {
super(msg, rootCause);
@@ -134,7 +134,7 @@ public class EmailException extends Exception {
/**
* Constructs a new {@code EmailException} with specified nested {@code
Throwable} root cause.
*
- * @param rootCause the exception or error that caused this exception to
be thrown.
+ * @param rootCause The exception or error that caused this exception to
be thrown.
*/
public EmailException(final Throwable rootCause) {
super(rootCause);
diff --git
a/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailUtils.java
b/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailUtils.java
index 1aa5ac27..1634749f 100644
---
a/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailUtils.java
+++
b/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailUtils.java
@@ -94,7 +94,7 @@ public final class EmailUtils {
/**
* Checks that the given file exists and is not a directory.
*
- * @param file the file to check.
+ * @param file The file to check.
* @return The given file if it exists and is not a directory.
* @throws IOException if the given file does not exist or is a directory.
* @since 2.0.0-M2
@@ -113,7 +113,7 @@ public final class EmailUtils {
/**
* Checks that the given file exists and is not a directory.
*
- * @param file the file to check.
+ * @param file The file to check.
* @return The given file if it exists and is not a directory.
* @throws IOException if the given file does not exist or is a directory.
* @since 2.0.0-M2
@@ -132,7 +132,7 @@ public final class EmailUtils {
/**
* Encodes an input string according to RFC 2392. Unsafe characters are
escaped.
*
- * @param input the input string to be URL encoded
+ * @param input The input string to be URL encoded
* @return A URL encoded string
* @see <a href="https://tools.ietf.org/html/rfc2392";>RFC 2392</a>
*/
@@ -159,7 +159,7 @@ public final class EmailUtils {
/**
* Tests whether the given collection is null or empty.
*
- * @param collection the collection to test.
+ * @param collection The collection to test.
* @return whether the given collection is null or empty.
*/
public static boolean isEmpty(final Collection<?> collection) {
@@ -169,7 +169,7 @@ public final class EmailUtils {
/**
* Tests whether the given map is null or empty.
*
- * @param map the map to test.
+ * @param map The map to test.
* @return whether the given map is null or empty.
*/
public static boolean isEmpty(final Map<?, ?> map) {
@@ -179,7 +179,7 @@ public final class EmailUtils {
/**
* Tests whether the given array is null or empty.
*
- * @param array the collection to test.
+ * @param array The collection to test.
* @return whether the given array is null or empty.
*/
public static boolean isEmpty(final Object[] array) {
@@ -192,7 +192,7 @@ public final class EmailUtils {
* Copied from Commons Lang 2.1, svn 240418
* </p>
*
- * @param str the String to check, may be null
+ * @param str The String to check, may be null
* @return {@code true} if the String is empty or null
*/
public static boolean isEmpty(final String str) {
@@ -205,7 +205,7 @@ public final class EmailUtils {
* Copied from Commons Lang 2.1, svn 240418
* </p>
*
- * @param str the String to check, may be null
+ * @param str The String to check, may be null
* @return {@code true} if the String is not empty and not null
*/
public static boolean isNotEmpty(final String str) {
@@ -229,13 +229,13 @@ public final class EmailUtils {
* Copied from Commons Lang 2.1, svn 201930
* </p>
*
- * @param count the length of random string to create
- * @param start the position in set of chars to start at
- * @param end the position in set of chars to end before
+ * @param count The length of random string to create
+ * @param start The position in set of chars to start at
+ * @param end The position in set of chars to end before
* @param letters only allow letters?
* @param numbers only allow numbers?
- * @param chars the set of chars to choose randoms from. If {@code
null}, then it will use the set of all chars.
- * @param random a source of randomness.
+ * @param chars The set of chars to choose randoms from. If {@code
null}, then it will use the set of all chars.
+ * @param random A source of randomness.
* @return The random string
* @throws IllegalArgumentException if {@code count} < 0.
*/
@@ -289,7 +289,7 @@ public final class EmailUtils {
* Copied from Commons Lang 2.1, svn 201930
* </p>
*
- * @param count the length of random string to create
+ * @param count The length of random string to create
* @return The random string
*/
public static String randomAlphabetic(final int count) {
@@ -299,7 +299,7 @@ public final class EmailUtils {
/**
* Replaces end-of-line characters with spaces.
*
- * @param input the input string to be scanned.
+ * @param input The input string to be scanned.
* @return A clean string
*/
public static String replaceEndOfLineCharactersWithSpaces(final String
input) {
@@ -309,7 +309,7 @@ public final class EmailUtils {
/**
* Converts the given string to lower case.
*
- * @param value the input string.
+ * @param value The input string.
* @return A lower case string.
*/
public static String toLower(final String value) {
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/DataSourceResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/DataSourceResolver.java
index 19c92ddc..25f5228b 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/DataSourceResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/DataSourceResolver.java
@@ -30,7 +30,7 @@ public interface DataSourceResolver {
/**
* Resolves the given resource location to a {@code DataSource}.
*
- * @param resourceLocation the location of the resource
+ * @param resourceLocation The location of the resource
* @return The {@code DataSource}
* @throws IOException the resource was not found
*/
@@ -39,7 +39,7 @@ public interface DataSourceResolver {
/**
* Resolves the given resource location to a {@code DataSource}.
*
- * @param resourceLocation the location of the resource
+ * @param resourceLocation The location of the resource
* @param isLenient shall we ignore resources not found or complain
with an exception?
* @return The data source containing the resource or null if the resource
was not found in lenient mode
* @throws IOException resolving the resource failed
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
index fc6da9b7..5f2e931a 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
@@ -600,8 +600,8 @@ public abstract class Email {
/**
* Creates a folded header value containing 76 character chunks.
*
- * @param name the name of the header
- * @param value the value of the header
+ * @param name The name of the header
+ * @param value The value of the header
* @return The folded header value
* @throws IllegalArgumentException if either the name or value is null or
empty
*/
@@ -1113,7 +1113,7 @@ public abstract class Email {
* This method should be used when your outgoing mail server requires
authentication. Your mail server must also support RFC2554.
* </p>
*
- * @param authenticator the {@code Authenticator} object.
+ * @param authenticator The {@code Authenticator} object.
* @see Authenticator
* @since 1.0
*/
@@ -1202,7 +1202,7 @@ public abstract class Email {
/**
* Sets the content.
*
- * @param content the content.
+ * @param content The content.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1226,7 +1226,7 @@ public abstract class Email {
/**
* Sets the content type.
*
- * @param contentType the content type.
+ * @param contentType The content type.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1292,7 +1292,7 @@ public abstract class Email {
/**
* Sets the From address.
*
- * @param fromAddress the From address.
+ * @param fromAddress The From address.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1390,7 +1390,7 @@ public abstract class Email {
/**
* Sets the MIME message.
*
- * @param message the MIME message.
+ * @param message The MIME message.
*/
public void setMessage(final MimeMessage message) {
this.message = message;
@@ -1451,7 +1451,7 @@ public abstract class Email {
/**
* Sets the POP3 password.
*
- * @param popPassword the POP3 password.
+ * @param popPassword The POP3 password.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1464,7 +1464,7 @@ public abstract class Email {
/**
* Sets the POP3 user name.
*
- * @param popUserName the POP3 user name.
+ * @param popUserName The POP3 user name.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1542,7 +1542,7 @@ public abstract class Email {
/**
* Sets the socket connection timeout value in milliseconds. Default is a
60 second timeout.
*
- * @param socketConnectionTimeout the connection timeout
+ * @param socketConnectionTimeout The connection timeout
* @throws IllegalStateException if the mail session is already initialized
* @since 1.6.0
*/
@@ -1554,7 +1554,7 @@ public abstract class Email {
/**
* Sets the socket I/O timeout value in milliseconds. Default is 60 second
timeout.
*
- * @param socketTimeout the socket I/O timeout
+ * @param socketTimeout The socket I/O timeout
* @throws IllegalStateException if the mail session is already initialized
* @since 1.6.0
*/
@@ -1599,7 +1599,7 @@ public abstract class Email {
/**
* Sets the SSL port to use for the SMTP transport. Defaults to the
standard port, 465.
*
- * @param sslSmtpPort the SSL port to use for the SMTP transport
+ * @param sslSmtpPort The SSL port to use for the SMTP transport
* @throws IllegalStateException if the mail session is already initialized
* @see #setSmtpPort(int)
*/
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/HtmlEmail.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/HtmlEmail.java
index ba1a375c..b84e511a 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/HtmlEmail.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/HtmlEmail.java
@@ -100,9 +100,9 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Creates an InlineImage object to represent the specified content ID
and {@code MimeBodyPart}.
*
- * @param cid the generated content ID, not null.
- * @param dataSource the {@code DataSource} that represents the
content, not null.
- * @param mimeBodyPart the {@code MimeBodyPart} that contains the
encoded data, not null.
+ * @param cid The generated content ID, not null.
+ * @param dataSource The {@code DataSource} that represents the
content, not null.
+ * @param mimeBodyPart The {@code MimeBodyPart} that contains the
encoded data, not null.
*/
private InlineImage(final String cid, final DataSource dataSource,
final MimeBodyPart mimeBodyPart) {
this.cid = Objects.requireNonNull(cid, "cid");
@@ -294,8 +294,8 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Embeds the specified {@code DataSource} in the HTML using a randomly
generated Content-ID. Returns the generated Content-ID string.
*
- * @param dataSource the {@code DataSource} to embed
- * @param name the name that will be set in the file name header
field
+ * @param dataSource The {@code DataSource} to embed
+ * @param name The name that will be set in the file name header
field
* @return The generated Content-ID for this {@code DataSource}
* @throws EmailException if the embedding fails or if {@code name} is
null or empty
* @see #embed(DataSource, String, String)
@@ -322,9 +322,9 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Embeds the specified {@code DataSource} in the HTML using the specified
Content-ID. Returns the specified Content-ID string.
*
- * @param dataSource the {@code DataSource} to embed
- * @param name the name that will be set in the file name header
field
- * @param cid the Content-ID to use for this {@code DataSource}
+ * @param dataSource The {@code DataSource} to embed
+ * @param name The name that will be set in the file name header
field
+ * @param cid The Content-ID to use for this {@code DataSource}
* @return The URL encoded Content-ID for this {@code DataSource}
* @throws EmailException if the embedding fails or if {@code name} is
null or empty
* @since 1.1
@@ -373,7 +373,7 @@ public class HtmlEmail extends MultiPartEmail {
* changed.
*
* @param file The {@code File} to embed
- * @param cid the Content-ID to use for the embedded {@code File}
+ * @param cid The Content-ID to use for the embedded {@code File}
* @return A String with the Content-ID of the file.
* @throws EmailException when the supplied {@code File} cannot be used or
if the file has already been embedded; also see
* {@link jakarta.mail.internet.MimeBodyPart} for
definitions
@@ -538,7 +538,7 @@ public class HtmlEmail extends MultiPartEmail {
* message is formatted in HTML for the HTML part of the message; it is
left as is in the alternate text part.
* </p>
*
- * @param msg the message text to use
+ * @param msg The message text to use
* @return this {@code HtmlEmail}
* @throws EmailException if msg is null or empty; see
jakarta.mail.internet.MimeBodyPart for definitions
* @since 1.0
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/ImageHtmlEmail.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/ImageHtmlEmail.java
index 12871427..7bb39806 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/ImageHtmlEmail.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/ImageHtmlEmail.java
@@ -104,8 +104,8 @@ public class ImageHtmlEmail extends HtmlEmail {
/**
* Replace the regexp matching resource locations with "cid:..."
references.
*
- * @param htmlMessage the HTML message to analyze
- * @param pattern the regular expression to find resources
+ * @param htmlMessage The HTML message to analyze
+ * @param pattern The regular expression to find resources
* @return The HTML message containing "cid" references
* @throws EmailException creating the email failed
* @throws IOException resolving the resources failed
@@ -173,7 +173,7 @@ public class ImageHtmlEmail extends HtmlEmail {
/**
* Sets the data source resolver.
*
- * @param dataSourceResolver the resolver
+ * @param dataSourceResolver The resolver
*/
public void setDataSourceResolver(final DataSourceResolver
dataSourceResolver) {
this.dataSourceResolver = dataSourceResolver;
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/MultiPartEmail.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/MultiPartEmail.java
index 88797f93..2d2731a4 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/MultiPartEmail.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/MultiPartEmail.java
@@ -416,7 +416,7 @@ public class MultiPartEmail extends Email {
/**
* Sets whether there are attachments.
*
- * @param hasAttachments the attachments flag
+ * @param hasAttachments The attachments flag
* @since 1.0
*/
public void setBoolHasAttachments(final boolean hasAttachments) {
@@ -426,7 +426,7 @@ public class MultiPartEmail extends Email {
/**
* Sets the initialized status of this object.
*
- * @param initialized the initialized status flag
+ * @param initialized The initialized status flag
*/
protected void setInitialized(final boolean initialized) {
this.initialized = initialized;
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/activation/PathDataSource.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/activation/PathDataSource.java
index af846a9c..02688b3e 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/activation/PathDataSource.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/activation/PathDataSource.java
@@ -62,7 +62,7 @@ public final class PathDataSource implements DataSource {
* <p>
* The type map defaults to {@link FileTypeMap#getDefaultFileTypeMap()}.
*
- * @param path the path
+ * @param path The path
*/
public PathDataSource(final Path path) {
this(path, FileTypeMap.getDefaultFileTypeMap());
@@ -74,8 +74,8 @@ public final class PathDataSource implements DataSource {
* The file will not actually be opened until a method is called that
requires the path to be opened.
* </p>
*
- * @param path the path, non-null.
- * @param typeMap the type map, non-null.
+ * @param path The path, non-null.
+ * @param typeMap The type map, non-null.
* @param options options for opening file streams.
*/
public PathDataSource(final Path path, final FileTypeMap typeMap, final
OpenOption... options) {
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceBaseResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceBaseResolver.java
index 35b27263..69cec2d8 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceBaseResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceBaseResolver.java
@@ -47,7 +47,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether the argument is a content id.
*
- * @param resourceLocation the resource location to test.
+ * @param resourceLocation The resource location to test.
* @return true if it is a CID.
*/
protected boolean isCid(final String resourceLocation) {
@@ -57,7 +57,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether this a file URL.
*
- * @param urlString the URL string.
+ * @param urlString The URL string.
* @return true if it is a file URL.
*/
protected boolean isFileUrl(final String urlString) {
@@ -67,7 +67,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether this a HTTP or HTTPS URL.
*
- * @param urlString the URL string to test.
+ * @param urlString The URL string to test.
* @return true if it is a HTTP or HTTPS URL.
*/
protected boolean isHttpUrl(final String urlString) {
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceClassPathResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceClassPathResolver.java
index 9b111e96..e9e43aa4 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceClassPathResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceClassPathResolver.java
@@ -44,7 +44,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param classPathBase a base class path
+ * @param classPathBase A base class path
*/
public DataSourceClassPathResolver(final String classPathBase) {
this(classPathBase, false);
@@ -53,7 +53,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param classPathBase a base class path
+ * @param classPathBase A base class path
* @param lenient shall we ignore resources not found or throw an
exception?
*/
public DataSourceClassPathResolver(final String classPathBase, final
boolean lenient) {
@@ -73,7 +73,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Returns the resource name for a given resource location.
*
- * @param resourceLocation the resource location
+ * @param resourceLocation The resource location
* @return {@link #getClassPathBase()} + {@code resourceLocation}
* @see #getClassPathBase()
*/
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceCompositeResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceCompositeResolver.java
index 13a3e382..ccb012fc 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceCompositeResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceCompositeResolver.java
@@ -35,7 +35,7 @@ public class DataSourceCompositeResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param dataSourceResolvers a list of resolvers being used
+ * @param dataSourceResolvers A list of resolvers being used
*/
public DataSourceCompositeResolver(final DataSourceResolver[]
dataSourceResolvers) {
this.dataSourceResolvers = dataSourceResolvers.clone();
@@ -44,7 +44,7 @@ public class DataSourceCompositeResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param dataSourceResolvers a list of resolvers being used
+ * @param dataSourceResolvers A list of resolvers being used
* @param isLenient shall we ignore resources not found or throw
an exception?
*/
public DataSourceCompositeResolver(final DataSourceResolver[]
dataSourceResolvers, final boolean isLenient) {
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceFileResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceFileResolver.java
index cbac73b9..6a22fd53 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceFileResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceFileResolver.java
@@ -42,7 +42,7 @@ public class DataSourceFileResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
*/
public DataSourceFileResolver(final File baseDir) {
this.baseDir = baseDir;
@@ -51,7 +51,7 @@ public class DataSourceFileResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
* @param lenient shall we ignore resources not found or complain with an
exception
*/
public DataSourceFileResolver(final File baseDir, final boolean lenient) {
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourcePathResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourcePathResolver.java
index b72a54bf..e295077e 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourcePathResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourcePathResolver.java
@@ -54,7 +54,7 @@ public final class DataSourcePathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
*/
public DataSourcePathResolver(final Path baseDir) {
this(baseDir, false);
@@ -63,7 +63,7 @@ public final class DataSourcePathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
* @param lenient shall we ignore resources not found or complain with an
exception
* @param options options for opening streams.
*/
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceUrlResolver.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceUrlResolver.java
index fd20f054..42f78d4c 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceUrlResolver.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/resolver/DataSourceUrlResolver.java
@@ -39,7 +39,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseUrl the base URL used for resolving relative resource
locations
+ * @param baseUrl The base URL used for resolving relative resource
locations
*/
public DataSourceUrlResolver(final URL baseUrl) {
this.baseUrl = baseUrl;
@@ -48,7 +48,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseUrl the base URL used for resolving relative resource
locations
+ * @param baseUrl The base URL used for resolving relative resource
locations
* @param lenient shall we ignore resources not found or complain with an
exception
*/
public DataSourceUrlResolver(final URL baseUrl, final boolean lenient) {
@@ -59,7 +59,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Create an URL based on a base URL and a resource location suitable for
loading the resource.
*
- * @param resourceLocation a resource location
+ * @param resourceLocation A resource location
* @return The corresponding URL
* @throws java.net.MalformedURLException creating the URL failed
*/
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageParser.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageParser.java
index 982ce94a..e622d3fa 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageParser.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageParser.java
@@ -70,7 +70,7 @@ public class MimeMessageParser {
/**
* Constructs an instance with the MimeMessage to be extracted.
*
- * @param mimeMessage the message to parse
+ * @param mimeMessage The message to parse
*/
public MimeMessageParser(final MimeMessage mimeMessage) {
this.attachmentList = new ArrayList<>();
@@ -86,8 +86,8 @@ public class MimeMessageParser {
/**
* Parses the MimePart to create a DataSource.
*
- * @param parent the parent multi-part
- * @param part the current part to be processed
+ * @param parent The parent multi-part
+ * @param part The current part to be processed
* @return The DataSource
* @throws MessagingException creating the DataSource failed
* @throws IOException error getting InputStream or unsupported
encoding
@@ -106,7 +106,7 @@ public class MimeMessageParser {
* The content-id must be stripped of any angle brackets, i.e. "part1"
instead of "<part1>".
* </p>
*
- * @param cid the content-id of the attachment
+ * @param cid The content-id of the attachment
* @return The corresponding datasource or null if nothing was found
* @since 1.3.4
*/
@@ -117,7 +117,7 @@ public class MimeMessageParser {
/**
* Find an attachment using its name.
*
- * @param name the name of the attachment
+ * @param name The name of the attachment
* @return The corresponding datasource or null if nothing was found
*/
public DataSource findAttachmentByName(final String name) {
@@ -141,7 +141,7 @@ public class MimeMessageParser {
/**
* Gets the MIME type.
*
- * @param fullMimeType the mime type from the mail API
+ * @param fullMimeType The mime type from the mail API
* @return The real mime type
*/
private String getBaseMimeType(final String fullMimeType) {
@@ -185,8 +185,8 @@ public class MimeMessageParser {
/**
* Determines the name of the data source if it is not already set.
*
- * @param part the mail part
- * @param dataSource the data source
+ * @param part The mail part
+ * @param dataSource The data source
* @return The name of the data source or {@code null} if no name can be
determined
* @throws MessagingException accessing the part failed
* @throws UnsupportedEncodingException decoding the text failed
@@ -317,8 +317,8 @@ public class MimeMessageParser {
/**
* Tests whether the MimePart contains an object of the given mime type.
*
- * @param part the current MimePart
- * @param mimeType the mime type to check
+ * @param part The current MimePart
+ * @param mimeType The mime type to check
* @return {@code true} if the MimePart matches the given mime type,
{@code false} otherwise
* @throws MessagingException parsing the MimeMessage failed
*/
@@ -356,8 +356,8 @@ public class MimeMessageParser {
/**
* Extracts the content of a MimeMessage recursively.
*
- * @param parent the parent multi-part
- * @param part the current MimePart
+ * @param parent The parent multi-part
+ * @param part The current MimePart
* @throws MessagingException parsing the MimeMessage failed
* @throws IOException parsing the MimeMessage failed
*/
@@ -387,7 +387,7 @@ public class MimeMessageParser {
/**
* Strips the content id of any whitespace and angle brackets.
*
- * @param contentId the string to strip
+ * @param contentId The string to strip
* @return A stripped version of the content id
*/
private String stripContentId(final String contentId) {
diff --git
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageUtils.java
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageUtils.java
index 8699a24e..f08c46dd 100644
---
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageUtils.java
+++
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/util/MimeMessageUtils.java
@@ -41,8 +41,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
@@ -56,8 +56,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
@@ -69,8 +69,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
*/
@@ -81,8 +81,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @param options options specifying how the file is opened.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
@@ -97,8 +97,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage using the platform's default character encoding.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
@@ -111,8 +111,8 @@ public final class MimeMessageUtils {
/**
* Writes a MimeMessage into a file.
*
- * @param mimeMessage the MimeMessage to write.
- * @param resultFile the file containing the MimeMessage.
+ * @param mimeMessage The MimeMessage to write.
+ * @param resultFile The file containing the MimeMessage.
* @throws MessagingException accessing MimeMessage failed.
* @throws IOException writing the MimeMessage failed.
*/
diff --git
a/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/AbstractEmailTest.java
b/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/AbstractEmailTest.java
index 4b7c9604..048b1b5b 100644
---
a/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/AbstractEmailTest.java
+++
b/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/AbstractEmailTest.java
@@ -152,7 +152,7 @@ public abstract class AbstractEmailTest {
}
/**
- * @param intMsgNo the message to retrieve
+ * @param intMsgNo The message to retrieve
* @return message as string
*/
public String getMessageAsString(final int intMsgNo) {
@@ -367,7 +367,7 @@ public abstract class AbstractEmailTest {
*
* @param mailServer reference to the fake mail server
* @param strSubject expected subject
- * @param content the expected message content
+ * @param content The expected message content
* @param fromAdd expected from address
* @param toAdd list of expected to addresses
* @param ccAdd list of expected cc addresses
@@ -397,7 +397,7 @@ public abstract class AbstractEmailTest {
*
* @param mailServer reference to the fake mail server
* @param strSubject expected subject
- * @param strMessage the expected message as a string
+ * @param strMessage The expected message as a string
* @param fromAdd expected from address
* @param toAdd list of expected to addresses
* @param ccAdd list of expected cc addresses
diff --git
a/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/EmailLiveTest.java
b/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/EmailLiveTest.java
index 88b5092f..292a1e3f 100644
---
a/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/EmailLiveTest.java
+++
b/commons-email2-jakarta/src/test/java/org/apache/commons/mail2/jakarta/EmailLiveTest.java
@@ -51,7 +51,7 @@ class EmailLiveTest extends AbstractEmailTest {
/**
* Factory method to create a pre-configured email instance.
*
- * @param clazz the requested implementation class
+ * @param clazz The requested implementation class
* @return The new instance
* @throws Exception creating the Email instance failed
*/
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/DataSourceResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/DataSourceResolver.java
index 3d5f1f0b..d4d1a7c3 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/DataSourceResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/DataSourceResolver.java
@@ -30,7 +30,7 @@ public interface DataSourceResolver {
/**
* Resolves the given resource location to a {@code DataSource}.
*
- * @param resourceLocation the location of the resource
+ * @param resourceLocation The location of the resource
* @return The {@code DataSource}
* @throws IOException the resource was not found
*/
@@ -39,7 +39,7 @@ public interface DataSourceResolver {
/**
* Resolves the given resource location to a {@code DataSource}.
*
- * @param resourceLocation the location of the resource
+ * @param resourceLocation The location of the resource
* @param isLenient shall we ignore resources not found or complain
with an exception?
* @return The data source containing the resource or null if the resource
was not found in lenient mode
* @throws IOException resolving the resource failed
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
index 72745589..d143ccc8 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
@@ -599,8 +599,8 @@ public abstract class Email {
/**
* Creates a folded header value containing 76 character chunks.
*
- * @param name the name of the header
- * @param value the value of the header
+ * @param name The name of the header
+ * @param value The value of the header
* @return The folded header value
* @throws IllegalArgumentException if either the name or value is null or
empty
*/
@@ -1112,7 +1112,7 @@ public abstract class Email {
* This method should be used when your outgoing mail server requires
authentication. Your mail server must also support RFC2554.
* </p>
*
- * @param authenticator the {@code Authenticator} object.
+ * @param authenticator The {@code Authenticator} object.
* @see Authenticator
* @since 1.0
*/
@@ -1201,7 +1201,7 @@ public abstract class Email {
/**
* Sets the content.
*
- * @param content the content.
+ * @param content The content.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1225,7 +1225,7 @@ public abstract class Email {
/**
* Sets the content type.
*
- * @param contentType the content type.
+ * @param contentType The content type.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1291,7 +1291,7 @@ public abstract class Email {
/**
* Sets the From address.
*
- * @param fromAddress the From address.
+ * @param fromAddress The From address.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1389,7 +1389,7 @@ public abstract class Email {
/**
* Sets the MIME message.
*
- * @param message the MIME message.
+ * @param message The MIME message.
*/
public void setMessage(final MimeMessage message) {
this.message = message;
@@ -1450,7 +1450,7 @@ public abstract class Email {
/**
* Sets the POP3 password.
*
- * @param popPassword the POP3 password.
+ * @param popPassword The POP3 password.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1463,7 +1463,7 @@ public abstract class Email {
/**
* Sets the POP3 user name.
*
- * @param popUserName the POP3 user name.
+ * @param popUserName The POP3 user name.
* @return {@code this} instance.
* @since 1.6.0
*/
@@ -1541,7 +1541,7 @@ public abstract class Email {
/**
* Sets the socket connection timeout value in milliseconds. Default is a
60 second timeout.
*
- * @param socketConnectionTimeout the connection timeout
+ * @param socketConnectionTimeout The connection timeout
* @throws IllegalStateException if the mail session is already initialized
* @since 1.6.0
*/
@@ -1553,7 +1553,7 @@ public abstract class Email {
/**
* Sets the socket I/O timeout value in milliseconds. Default is 60 second
timeout.
*
- * @param socketTimeout the socket I/O timeout
+ * @param socketTimeout The socket I/O timeout
* @throws IllegalStateException if the mail session is already initialized
* @since 1.6.0
*/
@@ -1598,7 +1598,7 @@ public abstract class Email {
/**
* Sets the SSL port to use for the SMTP transport. Defaults to the
standard port, 465.
*
- * @param sslSmtpPort the SSL port to use for the SMTP transport
+ * @param sslSmtpPort The SSL port to use for the SMTP transport
* @throws IllegalStateException if the mail session is already initialized
* @see #setSmtpPort(int)
*/
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/HtmlEmail.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/HtmlEmail.java
index 5b034b71..8d01adc8 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/HtmlEmail.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/HtmlEmail.java
@@ -100,9 +100,9 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Creates an InlineImage object to represent the specified content ID
and {@code MimeBodyPart}.
*
- * @param cid the generated content ID, not null.
- * @param dataSource the {@code DataSource} that represents the
content, not null.
- * @param mimeBodyPart the {@code MimeBodyPart} that contains the
encoded data, not null.
+ * @param cid The generated content ID, not null.
+ * @param dataSource The {@code DataSource} that represents the
content, not null.
+ * @param mimeBodyPart The {@code MimeBodyPart} that contains the
encoded data, not null.
*/
private InlineImage(final String cid, final DataSource dataSource,
final MimeBodyPart mimeBodyPart) {
this.cid = Objects.requireNonNull(cid, "cid");
@@ -294,8 +294,8 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Embeds the specified {@code DataSource} in the HTML using a randomly
generated Content-ID. Returns the generated Content-ID string.
*
- * @param dataSource the {@code DataSource} to embed
- * @param name the name that will be set in the file name header
field
+ * @param dataSource The {@code DataSource} to embed
+ * @param name The name that will be set in the file name header
field
* @return The generated Content-ID for this {@code DataSource}
* @throws EmailException if the embedding fails or if {@code name} is
null or empty
* @see #embed(DataSource, String, String)
@@ -322,9 +322,9 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Embeds the specified {@code DataSource} in the HTML using the specified
Content-ID. Returns the specified Content-ID string.
*
- * @param dataSource the {@code DataSource} to embed
- * @param name the name that will be set in the file name header
field
- * @param cid the Content-ID to use for this {@code DataSource}
+ * @param dataSource The {@code DataSource} to embed
+ * @param name The name that will be set in the file name header
field
+ * @param cid The Content-ID to use for this {@code DataSource}
* @return The URL encoded Content-ID for this {@code DataSource}
* @throws EmailException if the embedding fails or if {@code name} is
null or empty
* @since 1.1
@@ -373,7 +373,7 @@ public class HtmlEmail extends MultiPartEmail {
* changed.
*
* @param file The {@code File} to embed
- * @param cid the Content-ID to use for the embedded {@code File}
+ * @param cid The Content-ID to use for the embedded {@code File}
* @return A String with the Content-ID of the file.
* @throws EmailException when the supplied {@code File} cannot be used or
if the file has already been embedded; also see
* {@link javax.mail.internet.MimeBodyPart} for
definitions
@@ -538,7 +538,7 @@ public class HtmlEmail extends MultiPartEmail {
* message is formatted in HTML for the HTML part of the message; it is
left as is in the alternate text part.
* </p>
*
- * @param msg the message text to use
+ * @param msg The message text to use
* @return this {@code HtmlEmail}
* @throws EmailException if msg is null or empty; see
javax.mail.internet.MimeBodyPart for definitions
* @since 1.0
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/ImageHtmlEmail.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/ImageHtmlEmail.java
index 43d9bca6..c4eadcbc 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/ImageHtmlEmail.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/ImageHtmlEmail.java
@@ -104,8 +104,8 @@ public class ImageHtmlEmail extends HtmlEmail {
/**
* Replace the regexp matching resource locations with "cid:..."
references.
*
- * @param htmlMessage the HTML message to analyze
- * @param pattern the regular expression to find resources
+ * @param htmlMessage The HTML message to analyze
+ * @param pattern The regular expression to find resources
* @return The HTML message containing "cid" references
* @throws EmailException creating the email failed
* @throws IOException resolving the resources failed
@@ -173,7 +173,7 @@ public class ImageHtmlEmail extends HtmlEmail {
/**
* Sets the data source resolver.
*
- * @param dataSourceResolver the resolver
+ * @param dataSourceResolver The resolver
*/
public void setDataSourceResolver(final DataSourceResolver
dataSourceResolver) {
this.dataSourceResolver = dataSourceResolver;
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/MultiPartEmail.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/MultiPartEmail.java
index 4933035a..007cb84b 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/MultiPartEmail.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/MultiPartEmail.java
@@ -415,7 +415,7 @@ public class MultiPartEmail extends Email {
/**
* Sets whether there are attachments.
*
- * @param hasAttachments the attachments flag
+ * @param hasAttachments The attachments flag
* @since 1.0
*/
public void setBoolHasAttachments(final boolean hasAttachments) {
@@ -425,7 +425,7 @@ public class MultiPartEmail extends Email {
/**
* Sets the initialized status of this object.
*
- * @param initialized the initialized status flag
+ * @param initialized The initialized status flag
*/
protected void setInitialized(final boolean initialized) {
this.initialized = initialized;
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/activation/PathDataSource.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/activation/PathDataSource.java
index 14e6e4ef..aedce5fc 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/activation/PathDataSource.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/activation/PathDataSource.java
@@ -62,7 +62,7 @@ public final class PathDataSource implements DataSource {
* <p>
* The type map defaults to {@link FileTypeMap#getDefaultFileTypeMap()}.
*
- * @param path the path
+ * @param path The path
*/
public PathDataSource(final Path path) {
this(path, FileTypeMap.getDefaultFileTypeMap());
@@ -74,8 +74,8 @@ public final class PathDataSource implements DataSource {
* The file will not actually be opened until a method is called that
requires the path to be opened.
* </p>
*
- * @param path the path, non-null.
- * @param typeMap the type map, non-null.
+ * @param path The path, non-null.
+ * @param typeMap The type map, non-null.
* @param options options for opening file streams.
*/
public PathDataSource(final Path path, final FileTypeMap typeMap, final
OpenOption... options) {
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceBaseResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceBaseResolver.java
index 5343e513..7a2d97a9 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceBaseResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceBaseResolver.java
@@ -47,7 +47,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether the argument is a content id.
*
- * @param resourceLocation the resource location to test.
+ * @param resourceLocation The resource location to test.
* @return true if it is a CID.
*/
protected boolean isCid(final String resourceLocation) {
@@ -57,7 +57,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether this a file URL.
*
- * @param urlString the URL string.
+ * @param urlString The URL string.
* @return true if it is a file URL.
*/
protected boolean isFileUrl(final String urlString) {
@@ -67,7 +67,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether this a HTTP or HTTPS URL.
*
- * @param urlString the URL string to test.
+ * @param urlString The URL string to test.
* @return true if it is a HTTP or HTTPS URL.
*/
protected boolean isHttpUrl(final String urlString) {
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceClassPathResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceClassPathResolver.java
index b08a90bb..ac6c01c1 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceClassPathResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceClassPathResolver.java
@@ -44,7 +44,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param classPathBase a base class path
+ * @param classPathBase A base class path
*/
public DataSourceClassPathResolver(final String classPathBase) {
this(classPathBase, false);
@@ -53,7 +53,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param classPathBase a base class path
+ * @param classPathBase A base class path
* @param lenient shall we ignore resources not found or throw an
exception?
*/
public DataSourceClassPathResolver(final String classPathBase, final
boolean lenient) {
@@ -73,7 +73,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Returns the resource name for a given resource location.
*
- * @param resourceLocation the resource location
+ * @param resourceLocation The resource location
* @return {@link #getClassPathBase()} + {@code resourceLocation}
* @see #getClassPathBase()
*/
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceCompositeResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceCompositeResolver.java
index 986810d7..a115f2bd 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceCompositeResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceCompositeResolver.java
@@ -35,7 +35,7 @@ public class DataSourceCompositeResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param dataSourceResolvers a list of resolvers being used
+ * @param dataSourceResolvers A list of resolvers being used
*/
public DataSourceCompositeResolver(final DataSourceResolver[]
dataSourceResolvers) {
this.dataSourceResolvers = dataSourceResolvers.clone();
@@ -44,7 +44,7 @@ public class DataSourceCompositeResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param dataSourceResolvers a list of resolvers being used
+ * @param dataSourceResolvers A list of resolvers being used
* @param isLenient shall we ignore resources not found or throw
an exception?
*/
public DataSourceCompositeResolver(final DataSourceResolver[]
dataSourceResolvers, final boolean isLenient) {
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceFileResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceFileResolver.java
index d4676f40..e3644bdb 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceFileResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceFileResolver.java
@@ -42,7 +42,7 @@ public class DataSourceFileResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
*/
public DataSourceFileResolver(final File baseDir) {
this.baseDir = baseDir;
@@ -51,7 +51,7 @@ public class DataSourceFileResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
* @param lenient shall we ignore resources not found or complain with an
exception
*/
public DataSourceFileResolver(final File baseDir, final boolean lenient) {
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourcePathResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourcePathResolver.java
index 88ef53a0..d922e340 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourcePathResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourcePathResolver.java
@@ -54,7 +54,7 @@ public final class DataSourcePathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
*/
public DataSourcePathResolver(final Path baseDir) {
this(baseDir, false);
@@ -63,7 +63,7 @@ public final class DataSourcePathResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseDir the base directory of the resource when resolving
relative paths
+ * @param baseDir The base directory of the resource when resolving
relative paths
* @param lenient shall we ignore resources not found or complain with an
exception
* @param options options for opening streams.
*/
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceUrlResolver.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceUrlResolver.java
index a88e3011..81a19097 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceUrlResolver.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/resolver/DataSourceUrlResolver.java
@@ -39,7 +39,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseUrl the base URL used for resolving relative resource
locations
+ * @param baseUrl The base URL used for resolving relative resource
locations
*/
public DataSourceUrlResolver(final URL baseUrl) {
this.baseUrl = baseUrl;
@@ -48,7 +48,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Constructs a new instance.
*
- * @param baseUrl the base URL used for resolving relative resource
locations
+ * @param baseUrl The base URL used for resolving relative resource
locations
* @param lenient shall we ignore resources not found or complain with an
exception
*/
public DataSourceUrlResolver(final URL baseUrl, final boolean lenient) {
@@ -59,7 +59,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Create an URL based on a base URL and a resource location suitable for
loading the resource.
*
- * @param resourceLocation a resource location
+ * @param resourceLocation A resource location
* @return The corresponding URL
* @throws java.net.MalformedURLException creating the URL failed
*/
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageParser.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageParser.java
index c15b8480..61517e37 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageParser.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageParser.java
@@ -70,7 +70,7 @@ public class MimeMessageParser {
/**
* Constructs an instance with the MimeMessage to be extracted.
*
- * @param mimeMessage the message to parse
+ * @param mimeMessage The message to parse
*/
public MimeMessageParser(final MimeMessage mimeMessage) {
this.attachmentList = new ArrayList<>();
@@ -86,8 +86,8 @@ public class MimeMessageParser {
/**
* Parses the MimePart to create a DataSource.
*
- * @param parent the parent multi-part
- * @param part the current part to be processed
+ * @param parent The parent multi-part
+ * @param part The current part to be processed
* @return The DataSource
* @throws MessagingException creating the DataSource failed
* @throws IOException error getting InputStream or unsupported
encoding
@@ -106,7 +106,7 @@ public class MimeMessageParser {
* The content-id must be stripped of any angle brackets, i.e. "part1"
instead of "<part1>".
* </p>
*
- * @param cid the content-id of the attachment
+ * @param cid The content-id of the attachment
* @return The corresponding datasource or null if nothing was found
* @since 1.3.4
*/
@@ -117,7 +117,7 @@ public class MimeMessageParser {
/**
* Find an attachment using its name.
*
- * @param name the name of the attachment
+ * @param name The name of the attachment
* @return The corresponding datasource or null if nothing was found
*/
public DataSource findAttachmentByName(final String name) {
@@ -141,7 +141,7 @@ public class MimeMessageParser {
/**
* Gets the MIME type.
*
- * @param fullMimeType the mime type from the mail API
+ * @param fullMimeType The mime type from the mail API
* @return The real mime type
*/
private String getBaseMimeType(final String fullMimeType) {
@@ -185,8 +185,8 @@ public class MimeMessageParser {
/**
* Determines the name of the data source if it is not already set.
*
- * @param part the mail part
- * @param dataSource the data source
+ * @param part The mail part
+ * @param dataSource The data source
* @return The name of the data source or {@code null} if no name can be
determined
* @throws MessagingException accessing the part failed
* @throws UnsupportedEncodingException decoding the text failed
@@ -317,8 +317,8 @@ public class MimeMessageParser {
/**
* Tests whether the MimePart contains an object of the given mime type.
*
- * @param part the current MimePart
- * @param mimeType the mime type to check
+ * @param part The current MimePart
+ * @param mimeType The mime type to check
* @return {@code true} if the MimePart matches the given mime type,
{@code false} otherwise
* @throws MessagingException parsing the MimeMessage failed
*/
@@ -356,8 +356,8 @@ public class MimeMessageParser {
/**
* Extracts the content of a MimeMessage recursively.
*
- * @param parent the parent multi-part
- * @param part the current MimePart
+ * @param parent The parent multi-part
+ * @param part The current MimePart
* @throws MessagingException parsing the MimeMessage failed
* @throws IOException parsing the MimeMessage failed
*/
@@ -387,7 +387,7 @@ public class MimeMessageParser {
/**
* Strips the content id of any whitespace and angle brackets.
*
- * @param contentId the string to strip
+ * @param contentId The string to strip
* @return A stripped version of the content id
*/
private String stripContentId(final String contentId) {
diff --git
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageUtils.java
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageUtils.java
index 2a2e5a84..b08a2df5 100644
---
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageUtils.java
+++
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/util/MimeMessageUtils.java
@@ -41,8 +41,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
@@ -56,8 +56,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
@@ -69,8 +69,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
*/
@@ -81,8 +81,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @param options options specifying how the file is opened.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
@@ -97,8 +97,8 @@ public final class MimeMessageUtils {
/**
* Creates a MimeMessage using the platform's default character encoding.
*
- * @param session the mail session.
- * @param source the input data.
+ * @param session The mail session.
+ * @param source The input data.
* @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
@@ -111,8 +111,8 @@ public final class MimeMessageUtils {
/**
* Writes a MimeMessage into a file.
*
- * @param mimeMessage the MimeMessage to write.
- * @param resultFile the file containing the MimeMessage.
+ * @param mimeMessage The MimeMessage to write.
+ * @param resultFile The file containing the MimeMessage.
* @throws MessagingException accessing MimeMessage failed.
* @throws IOException writing the MimeMessage failed.
*/
diff --git
a/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/AbstractEmailTest.java
b/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/AbstractEmailTest.java
index ce397a27..f1e4ba43 100644
---
a/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/AbstractEmailTest.java
+++
b/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/AbstractEmailTest.java
@@ -153,7 +153,7 @@ public abstract class AbstractEmailTest {
}
/**
- * @param intMsgNo the message to retrieve
+ * @param intMsgNo The message to retrieve
* @return message as string
*/
public String getMessageAsString(final int intMsgNo) {
@@ -368,7 +368,7 @@ public abstract class AbstractEmailTest {
*
* @param mailServer reference to the fake mail server
* @param strSubject expected subject
- * @param content the expected message content
+ * @param content The expected message content
* @param fromAdd expected from address
* @param toAdd list of expected to addresses
* @param ccAdd list of expected cc addresses
@@ -398,7 +398,7 @@ public abstract class AbstractEmailTest {
*
* @param mailServer reference to the fake mail server
* @param strSubject expected subject
- * @param strMessage the expected message as a string
+ * @param strMessage The expected message as a string
* @param fromAdd expected from address
* @param toAdd list of expected to addresses
* @param ccAdd list of expected cc addresses
diff --git
a/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/EmailLiveTest.java
b/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/EmailLiveTest.java
index 55e7f59a..6733d397 100644
---
a/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/EmailLiveTest.java
+++
b/commons-email2-javax/src/test/java/org/apache/commons/mail2/javax/EmailLiveTest.java
@@ -51,7 +51,7 @@ class EmailLiveTest extends AbstractEmailTest {
/**
* Factory method to create a pre-configured email instance.
*
- * @param clazz the requested implementation class
+ * @param clazz The requested implementation class
* @return The new instance
* @throws Exception creating the Email instance failed
*/
