This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch 1.x
in repository https://gitbox.apache.org/repos/asf/commons-email.git
The following commit(s) were added to refs/heads/1.x by this push:
new c5a29cbe Javadoc
c5a29cbe is described below
commit c5a29cbe19bb9db4ecc71ba9a95af60b89f64bb4
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 08:45:24 2026 -0400
Javadoc
---
.../apache/commons/mail/DataSourceResolver.java | 4 +--
src/main/java/org/apache/commons/mail/Email.java | 36 +++++++++++-----------
.../java/org/apache/commons/mail/EmailUtils.java | 8 ++---
.../java/org/apache/commons/mail/HtmlEmail.java | 14 ++++-----
.../org/apache/commons/mail/ImageHtmlEmail.java | 4 +--
.../org/apache/commons/mail/MultiPartEmail.java | 4 +--
.../commons/mail/activation/PathDataSource.java | 6 ++--
.../mail/resolver/DataSourceBaseResolver.java | 2 +-
.../mail/resolver/DataSourceClassPathResolver.java | 2 +-
.../mail/resolver/DataSourceFileResolver.java | 2 +-
.../mail/resolver/DataSourcePathResolver.java | 2 +-
.../mail/resolver/DataSourceUrlResolver.java | 4 +--
.../commons/mail/util/MimeMessageParser.java | 24 +++++++--------
.../apache/commons/mail/util/MimeMessageUtils.java | 10 +++---
.../org/apache/commons/mail/AbstractEmailTest.java | 2 +-
.../org/apache/commons/mail/EmailLiveTest.java | 2 +-
16 files changed, 63 insertions(+), 63 deletions(-)
diff --git a/src/main/java/org/apache/commons/mail/DataSourceResolver.java
b/src/main/java/org/apache/commons/mail/DataSourceResolver.java
index aee6b007..73d0cf89 100644
--- a/src/main/java/org/apache/commons/mail/DataSourceResolver.java
+++ b/src/main/java/org/apache/commons/mail/DataSourceResolver.java
@@ -31,7 +31,7 @@ public interface DataSourceResolver {
* Resolves the given resource location to a {@code DataSource}.
*
* @param resourceLocation the location of the resource
- * @return the {@code DataSource}
+ * @return The {@code DataSource}
* @throws IOException the resource was not found
*/
DataSource resolve(final String resourceLocation) throws IOException;
@@ -41,7 +41,7 @@ public interface DataSourceResolver {
*
* @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
+ * @return The data source containing the resource or null if the resource
was not found in lenient mode
* @throws IOException resolving the resource failed
*/
DataSource resolve(final String resourceLocation, final boolean isLenient)
throws IOException;
diff --git a/src/main/java/org/apache/commons/mail/Email.java
b/src/main/java/org/apache/commons/mail/Email.java
index a4f55e2c..28ef2c6f 100644
--- a/src/main/java/org/apache/commons/mail/Email.java
+++ b/src/main/java/org/apache/commons/mail/Email.java
@@ -792,7 +792,7 @@ public abstract class Email {
*
* @param name the name of the header
* @param value the value of the header
- * @return the folded header value
+ * @return The folded header value
* @throws IllegalArgumentException if either the name or value is null or
empty
*/
private String createFoldedHeaderValue(final String name, final String
value) {
@@ -846,7 +846,7 @@ public abstract class Email {
* Creates a customized MimeMessage which can be implemented by a derived
class, e.g. to set the message id.
*
* @param aSession mail session to be used
- * @return the newly created message
+ * @return The newly created message
*/
protected MimeMessage createMimeMessage(final Session aSession) {
return new MimeMessage(aSession);
@@ -855,7 +855,7 @@ public abstract class Email {
/**
* Gets the authenticator.
*
- * @return the authenticator.
+ * @return The authenticator.
* @since 1.6.0
*/
public Authenticator getAuthenticator() {
@@ -874,7 +874,7 @@ public abstract class Email {
/**
* Gets the "bounce address" of this email.
*
- * @return the bounce address as string
+ * @return The bounce address as string
* @since 1.4
*/
public String getBounceAddress() {
@@ -893,7 +893,7 @@ public abstract class Email {
/**
* Gets the Charset.
*
- * @return the Charset.
+ * @return The Charset.
* @since 1.6.0
*/
public String getCharsetName() {
@@ -903,7 +903,7 @@ public abstract class Email {
/**
* Gets the content.
*
- * @return the content.
+ * @return The content.
* @since 1.6.0
*/
public Object getContent() {
@@ -913,7 +913,7 @@ public abstract class Email {
/**
* Gets the content type.
*
- * @return the content type.
+ * @return The content type.
* @since 1.6.0
*/
public String getContentType() {
@@ -923,7 +923,7 @@ public abstract class Email {
/**
* Gets the email body.
*
- * @return the email body.
+ * @return The email body.
* @since 1.6.0
*/
public MimeMultipart getEmailBody() {
@@ -1041,7 +1041,7 @@ public abstract class Email {
/**
* Gets the message.
*
- * @return the message.
+ * @return The message.
* @since 1.6.0
*/
public MimeMessage getMessage() {
@@ -1051,7 +1051,7 @@ public abstract class Email {
/**
* Gets the internal MimeMessage. Please note that the MimeMessage is
built by the buildMimeMessage() method.
*
- * @return the MimeMessage
+ * @return The MimeMessage
*/
public MimeMessage getMimeMessage() {
return message;
@@ -1060,7 +1060,7 @@ public abstract class Email {
/**
* Gets the POP3 host.
*
- * @return the POP3 host.
+ * @return The POP3 host.
* @since 1.6.0
*/
public String getPopHost() {
@@ -1070,7 +1070,7 @@ public abstract class Email {
/**
* Gets the POP3 password.
*
- * @return the POP3 password.
+ * @return The POP3 password.
* @since 1.6.0
*/
public String getPopPassword() {
@@ -1080,7 +1080,7 @@ public abstract class Email {
/**
* Gets the POP3 user name.
*
- * @return the POP3 user name.
+ * @return The POP3 user name.
* @since 1.6.0
*/
public String getPopUserName() {
@@ -1127,7 +1127,7 @@ public abstract class Email {
/**
* Gets the socket connection timeout value in milliseconds.
*
- * @return the timeout in milliseconds.
+ * @return The timeout in milliseconds.
* @since 1.2
*/
public int getSocketConnectionTimeout() {
@@ -1137,7 +1137,7 @@ public abstract class Email {
/**
* Gets the socket I/O timeout value in milliseconds.
*
- * @return the socket I/O timeout
+ * @return The socket I/O timeout
* @since 1.2
*/
public int getSocketTimeout() {
@@ -1147,7 +1147,7 @@ public abstract class Email {
/**
* Gets the current SSL port used by the SMTP transport.
*
- * @return the current SSL port used by the SMTP transport
+ * @return The current SSL port used by the SMTP transport
*/
public String getSslSmtpPort() {
if (session != null) {
@@ -1273,7 +1273,7 @@ public abstract class Email {
/**
* Sends the email. Internally we build a MimeMessage which is afterwards
sent to the SMTP server.
*
- * @return the message id of the underlying MimeMessage
+ * @return The message id of the underlying MimeMessage
* @throws IllegalStateException if the MimeMessage was already built,
that is, {@link #buildMimeMessage()} was already called
* @throws EmailException the sending failed
*/
@@ -1285,7 +1285,7 @@ public abstract class Email {
/**
* Sends the previously created MimeMessage to the SMTP server.
*
- * @return the message id of the underlying MimeMessage
+ * @return The message id of the underlying MimeMessage
* @throws IllegalArgumentException if the MimeMessage has not been created
* @throws EmailException the sending failed
*/
diff --git a/src/main/java/org/apache/commons/mail/EmailUtils.java
b/src/main/java/org/apache/commons/mail/EmailUtils.java
index 2efdcdc4..fb394419 100644
--- a/src/main/java/org/apache/commons/mail/EmailUtils.java
+++ b/src/main/java/org/apache/commons/mail/EmailUtils.java
@@ -100,7 +100,7 @@ final class EmailUtils {
* Checks that the given file exists and is not a directory.
*
* @param file the file to check.
- * @return the given file if it exists and is not a directory.
+ * @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.
*/
static File check(final File file) throws IOException {
@@ -118,7 +118,7 @@ final class EmailUtils {
* Checks that the given file exists and is not a directory.
*
* @param file the file to check.
- * @return the given file if it exists and is not a directory.
+ * @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.
*/
static Path check(final Path file) throws IOException {
@@ -221,7 +221,7 @@ final class EmailUtils {
* @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.
- * @return the random string
+ * @return The random string
* @throws IllegalArgumentException if {@code count} < 0.
*/
private static String random(int count, int start, int end, final boolean
letters, final boolean numbers, final char[] chars, final Random random) {
@@ -275,7 +275,7 @@ final class EmailUtils {
* </p>
*
* @param count the length of random string to create
- * @return the random string
+ * @return The random string
*/
static String randomAlphabetic(final int count) {
return random(count, 0, 0, true, false, null, RANDOM);
diff --git a/src/main/java/org/apache/commons/mail/HtmlEmail.java
b/src/main/java/org/apache/commons/mail/HtmlEmail.java
index 272df56b..ec472026 100644
--- a/src/main/java/org/apache/commons/mail/HtmlEmail.java
+++ b/src/main/java/org/apache/commons/mail/HtmlEmail.java
@@ -122,7 +122,7 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Returns the unique content ID of this InlineImage.
*
- * @return the unique content ID of this InlineImage
+ * @return The unique content ID of this InlineImage
*/
private String getCid() {
return cid;
@@ -131,7 +131,7 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Returns the {@code DataSource} that represents the encoded content.
*
- * @return the {@code DataSource} representing the encoded content
+ * @return The {@code DataSource} representing the encoded content
*/
private DataSource getDataSource() {
return dataSource;
@@ -140,7 +140,7 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Returns the {@code MimeBodyPart} that contains the encoded
InlineImage data.
*
- * @return the {@code MimeBodyPart} containing the encoded InlineImage
data
+ * @return The {@code MimeBodyPart} containing the encoded InlineImage
data
*/
private MimeBodyPart getMimeBodyPart() {
return mimeBodyPart;
@@ -308,7 +308,7 @@ public class HtmlEmail extends MultiPartEmail {
*
* @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}
+ * @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)
* @since 1.1
@@ -337,7 +337,7 @@ public class HtmlEmail extends MultiPartEmail {
* @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}
+ * @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
*/
@@ -513,7 +513,7 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Gets the HTML content.
*
- * @return the HTML content.
+ * @return The HTML content.
* @since 1.6.0
*/
public String getHtml() {
@@ -523,7 +523,7 @@ public class HtmlEmail extends MultiPartEmail {
/**
* Gets the message text.
*
- * @return the message text.
+ * @return The message text.
* @since 1.6.0
*/
public String getText() {
diff --git a/src/main/java/org/apache/commons/mail/ImageHtmlEmail.java
b/src/main/java/org/apache/commons/mail/ImageHtmlEmail.java
index 826f2345..e67e2b41 100644
--- a/src/main/java/org/apache/commons/mail/ImageHtmlEmail.java
+++ b/src/main/java/org/apache/commons/mail/ImageHtmlEmail.java
@@ -92,7 +92,7 @@ public class ImageHtmlEmail extends HtmlEmail {
/**
* Gets the data source resolver.
*
- * @return the resolver
+ * @return The resolver
*/
public DataSourceResolver getDataSourceResolver() {
return dataSourceResolver;
@@ -103,7 +103,7 @@ public class ImageHtmlEmail extends HtmlEmail {
*
* @param htmlMessage the HTML message to analyze
* @param pattern the regular expression to find resources
- * @return the HTML message containing "cid" references
+ * @return The HTML message containing "cid" references
* @throws EmailException creating the email failed
* @throws IOException resolving the resources failed
*/
diff --git a/src/main/java/org/apache/commons/mail/MultiPartEmail.java
b/src/main/java/org/apache/commons/mail/MultiPartEmail.java
index c31eccb2..eb68525a 100644
--- a/src/main/java/org/apache/commons/mail/MultiPartEmail.java
+++ b/src/main/java/org/apache/commons/mail/MultiPartEmail.java
@@ -326,7 +326,7 @@ public class MultiPartEmail extends Email {
/**
* Creates a body part object. Can be overridden if you don't want to
create a BodyPart.
*
- * @return the created body part
+ * @return The created body part
*/
protected BodyPart createBodyPart() {
return new MimeBodyPart();
@@ -335,7 +335,7 @@ public class MultiPartEmail extends Email {
/**
* Creates a mime multipart object.
*
- * @return the created mime part
+ * @return The created mime part
*/
protected MimeMultipart createMimeMultipart() {
return new MimeMultipart();
diff --git
a/src/main/java/org/apache/commons/mail/activation/PathDataSource.java
b/src/main/java/org/apache/commons/mail/activation/PathDataSource.java
index ec8c14d5..be2f84c5 100644
--- a/src/main/java/org/apache/commons/mail/activation/PathDataSource.java
+++ b/src/main/java/org/apache/commons/mail/activation/PathDataSource.java
@@ -81,7 +81,7 @@ public final class PathDataSource implements DataSource {
* By default, the {@link FileTypeMap} used will be a {@link
MimetypesFileTypeMap}.
* </p>
*
- * @return the MIME Type
+ * @return The MIME Type
* @see FileTypeMap#getDefaultFileTypeMap
*/
@Override
@@ -103,7 +103,7 @@ public final class PathDataSource implements DataSource {
/**
* Gets the <em>name</em> of this object. The FileDataSource will return
the file name of the object.
*
- * @return the name of the object or null.
+ * @return The name of the object or null.
* @see javax.activation.DataSource
*/
@Override
@@ -125,7 +125,7 @@ public final class PathDataSource implements DataSource {
/**
* Gets the File object that corresponds to this PathDataSource.
*
- * @return the File object for the file represented by this object.
+ * @return The File object for the file represented by this object.
*/
public Path getPath() {
return path;
diff --git
a/src/main/java/org/apache/commons/mail/resolver/DataSourceBaseResolver.java
b/src/main/java/org/apache/commons/mail/resolver/DataSourceBaseResolver.java
index 0eae4894..6033ddd8 100644
--- a/src/main/java/org/apache/commons/mail/resolver/DataSourceBaseResolver.java
+++ b/src/main/java/org/apache/commons/mail/resolver/DataSourceBaseResolver.java
@@ -77,7 +77,7 @@ public abstract class DataSourceBaseResolver implements
DataSourceResolver {
/**
* Tests whether to ignore resources not found or throw an exception.
*
- * @return the lenient flag.
+ * @return The lenient flag.
*/
public boolean isLenient() {
return lenient;
diff --git
a/src/main/java/org/apache/commons/mail/resolver/DataSourceClassPathResolver.java
b/src/main/java/org/apache/commons/mail/resolver/DataSourceClassPathResolver.java
index 4f0c391e..64bc98e5 100644
---
a/src/main/java/org/apache/commons/mail/resolver/DataSourceClassPathResolver.java
+++
b/src/main/java/org/apache/commons/mail/resolver/DataSourceClassPathResolver.java
@@ -64,7 +64,7 @@ public class DataSourceClassPathResolver extends
DataSourceBaseResolver {
/**
* Gets the class path base.
*
- * @return the classPathBase
+ * @return The classPathBase
*/
public String getClassPathBase() {
return classPathBase;
diff --git
a/src/main/java/org/apache/commons/mail/resolver/DataSourceFileResolver.java
b/src/main/java/org/apache/commons/mail/resolver/DataSourceFileResolver.java
index 81ff2f02..9cb9df7f 100644
--- a/src/main/java/org/apache/commons/mail/resolver/DataSourceFileResolver.java
+++ b/src/main/java/org/apache/commons/mail/resolver/DataSourceFileResolver.java
@@ -62,7 +62,7 @@ public class DataSourceFileResolver extends
DataSourceBaseResolver {
/**
* Gets the base directory used for resolving relative resource locations.
*
- * @return the baseUrl
+ * @return The baseUrl
*/
public File getBaseDir() {
return baseDir;
diff --git
a/src/main/java/org/apache/commons/mail/resolver/DataSourcePathResolver.java
b/src/main/java/org/apache/commons/mail/resolver/DataSourcePathResolver.java
index 851ef794..312b8ca6 100644
--- a/src/main/java/org/apache/commons/mail/resolver/DataSourcePathResolver.java
+++ b/src/main/java/org/apache/commons/mail/resolver/DataSourcePathResolver.java
@@ -70,7 +70,7 @@ public final class DataSourcePathResolver extends
DataSourceBaseResolver {
/**
* Gets the base directory used for resolving relative resource locations.
*
- * @return the baseUrl
+ * @return The baseUrl
*/
public Path getBaseDir() {
return baseDir;
diff --git
a/src/main/java/org/apache/commons/mail/resolver/DataSourceUrlResolver.java
b/src/main/java/org/apache/commons/mail/resolver/DataSourceUrlResolver.java
index abf5ce68..f55bfcfe 100644
--- a/src/main/java/org/apache/commons/mail/resolver/DataSourceUrlResolver.java
+++ b/src/main/java/org/apache/commons/mail/resolver/DataSourceUrlResolver.java
@@ -58,7 +58,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
- * @return the corresponding URL
+ * @return The corresponding URL
* @throws java.net.MalformedURLException creating the URL failed
*/
protected URL createUrl(final String resourceLocation) throws
MalformedURLException {
@@ -81,7 +81,7 @@ public class DataSourceUrlResolver extends
DataSourceBaseResolver {
/**
* Gets the base URL used for resolving relative resource locations.
*
- * @return the baseUrl
+ * @return The baseUrl
*/
public URL getBaseUrl() {
return baseUrl;
diff --git a/src/main/java/org/apache/commons/mail/util/MimeMessageParser.java
b/src/main/java/org/apache/commons/mail/util/MimeMessageParser.java
index c39def22..41489493 100644
--- a/src/main/java/org/apache/commons/mail/util/MimeMessageParser.java
+++ b/src/main/java/org/apache/commons/mail/util/MimeMessageParser.java
@@ -88,7 +88,7 @@ public class MimeMessageParser {
*
* @param parent the parent multi-part
* @param part the current part to be processed
- * @return the DataSource
+ * @return The DataSource
* @throws MessagingException creating the DataSource failed
* @throws IOException error getting InputStream or unsupported
encoding
*/
@@ -107,7 +107,7 @@ public class MimeMessageParser {
* </p>
*
* @param cid the content-id of the attachment
- * @return the corresponding datasource or null if nothing was found
+ * @return The corresponding datasource or null if nothing was found
* @since 1.3.4
*/
public DataSource findAttachmentByCid(final String cid) {
@@ -118,7 +118,7 @@ public class MimeMessageParser {
* Find an attachment using its name.
*
* @param name the name of the attachment
- * @return the corresponding datasource or null if nothing was found
+ * @return The corresponding datasource or null if nothing was found
*/
public DataSource findAttachmentByName(final String name) {
for (final DataSource dataSource : getAttachmentList()) {
@@ -142,7 +142,7 @@ public class MimeMessageParser {
* Gets the MIME type.
*
* @param fullMimeType the mime type from the mail API
- * @return the real mime type
+ * @return The real mime type
*/
private String getBaseMimeType(final String fullMimeType) {
final int pos = fullMimeType.indexOf(';');
@@ -152,7 +152,7 @@ public class MimeMessageParser {
/**
* Gets the BCC Address list.
*
- * @return the 'BCC' recipients of the message
+ * @return The 'BCC' recipients of the message
* @throws MessagingException determining the recipients failed
*/
public List<Address> getBcc() throws MessagingException {
@@ -162,7 +162,7 @@ public class MimeMessageParser {
/**
* Gets the CC Address list.
*
- * @return the 'CC' recipients of the message
+ * @return The 'CC' recipients of the message
* @throws MessagingException determining the recipients failed
*/
public List<Address> getCc() throws MessagingException {
@@ -175,7 +175,7 @@ public class MimeMessageParser {
* The content-ids are stripped of any angle brackets, i.e. "part1"
instead of "<part1>".
* </p>
*
- * @return the collection of content ids.
+ * @return The collection of content ids.
* @since 1.3.4
*/
public Collection<String> getContentIds() {
@@ -187,7 +187,7 @@ public class MimeMessageParser {
*
* @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
+ * @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
*/
@@ -207,7 +207,7 @@ public class MimeMessageParser {
/**
* Gets the FROM field.
*
- * @return the FROM field of the message
+ * @return The FROM field of the message
* @throws MessagingException parsing the mime message failed
*/
public String getFrom() throws MessagingException {
@@ -248,7 +248,7 @@ public class MimeMessageParser {
/**
* Gets the 'replyTo' address of the email.
*
- * @return the 'replyTo' address of the email
+ * @return The 'replyTo' address of the email
* @throws MessagingException parsing the mime message failed
*/
public String getReplyTo() throws MessagingException {
@@ -262,7 +262,7 @@ public class MimeMessageParser {
/**
* Gets the MIME message subject.
*
- * @return the MIME message subject.
+ * @return The MIME message subject.
* @throws MessagingException parsing the mime message failed.
*/
public String getSubject() throws MessagingException {
@@ -272,7 +272,7 @@ public class MimeMessageParser {
/**
* Gets the MIME message 'to' list.
*
- * @return the 'to' recipients of the message.
+ * @return The 'to' recipients of the message.
* @throws MessagingException determining the recipients failed
*/
public List<Address> getTo() throws MessagingException {
diff --git a/src/main/java/org/apache/commons/mail/util/MimeMessageUtils.java
b/src/main/java/org/apache/commons/mail/util/MimeMessageUtils.java
index b465ab22..3d2762cd 100644
--- a/src/main/java/org/apache/commons/mail/util/MimeMessageUtils.java
+++ b/src/main/java/org/apache/commons/mail/util/MimeMessageUtils.java
@@ -44,7 +44,7 @@ public final class MimeMessageUtils {
*
* @param session the mail session.
* @param source the input data.
- * @return the MimeMessage.
+ * @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
*/
@@ -59,7 +59,7 @@ public final class MimeMessageUtils {
*
* @param session the mail session.
* @param source the input data.
- * @return the MimeMessage.
+ * @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
*/
@@ -74,7 +74,7 @@ public final class MimeMessageUtils {
*
* @param session the mail session.
* @param source the input data.
- * @return the MimeMessage.
+ * @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
*/
public static MimeMessage createMimeMessage(final Session session, final
InputStream source) throws MessagingException {
@@ -87,7 +87,7 @@ public final class MimeMessageUtils {
* @param session the mail session.
* @param source the input data.
* @param options options specifying how the file is opened.
- * @return the MimeMessage.
+ * @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
*/
@@ -102,7 +102,7 @@ public final class MimeMessageUtils {
*
* @param session the mail session.
* @param source the input data.
- * @return the MimeMessage.
+ * @return The MimeMessage.
* @throws MessagingException creating the MimeMessage failed.
* @throws IOException creating the MimeMessage failed.
*/
diff --git a/src/test/java/org/apache/commons/mail/AbstractEmailTest.java
b/src/test/java/org/apache/commons/mail/AbstractEmailTest.java
index b3392966..631f137d 100644
--- a/src/test/java/org/apache/commons/mail/AbstractEmailTest.java
+++ b/src/test/java/org/apache/commons/mail/AbstractEmailTest.java
@@ -147,7 +147,7 @@ public abstract class AbstractEmailTest {
/**
* Gets the mail server port.
*
- * @return the port the server is running on.
+ * @return The port the server is running on.
*/
protected int getMailServerPort() {
return mailServerPort;
diff --git a/src/test/java/org/apache/commons/mail/EmailLiveTest.java
b/src/test/java/org/apache/commons/mail/EmailLiveTest.java
index 9d0ea842..305dfaa6 100644
--- a/src/test/java/org/apache/commons/mail/EmailLiveTest.java
+++ b/src/test/java/org/apache/commons/mail/EmailLiveTest.java
@@ -50,7 +50,7 @@ public class EmailLiveTest extends AbstractEmailTest {
* Factory method to create a pre-configured email instance.
*
* @param clazz the requested implementation class
- * @return the new instance
+ * @return The new instance
* @throws Exception creating the Email instance failed
*/
private Email create(final Class<? extends Email> clazz) throws Exception {
