This is an automated email from the ASF dual-hosted git repository.

rmaucher pushed a commit to branch 10.1.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git

commit 17feca509ca1a4c49c647941af93dc9f60758158
Author: remm <[email protected]>
AuthorDate: Mon May 11 13:40:29 2026 +0200

    Add Javadoc indicating that these classes are stubs
---
 java/jakarta/mail/Authenticator.java               | 1 +
 java/jakarta/mail/PasswordAuthentication.java      | 1 +
 java/jakarta/mail/Session.java                     | 1 +
 java/jakarta/mail/internet/InternetAddress.java    | 1 +
 java/jakarta/mail/internet/MimeMessage.java        | 1 +
 java/jakarta/mail/internet/MimePart.java           | 1 +
 java/jakarta/mail/internet/MimePartDataSource.java | 1 +
 7 files changed, 7 insertions(+)

diff --git a/java/jakarta/mail/Authenticator.java 
b/java/jakarta/mail/Authenticator.java
index 3896516877..be3e77db5b 100644
--- a/java/jakarta/mail/Authenticator.java
+++ b/java/jakarta/mail/Authenticator.java
@@ -20,6 +20,7 @@ package jakarta.mail;
  * Abstract base class for providing user authentication when establishing 
network connections. Subclasses override
  * {@link #getPasswordAuthentication} to return the appropriate credentials. 
This class is part of the Jakarta Mail
  * API and follows the pattern defined by {@link java.net.Authenticator}.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 public class Authenticator {
 
diff --git a/java/jakarta/mail/PasswordAuthentication.java 
b/java/jakarta/mail/PasswordAuthentication.java
index a76f8b7909..c86c39a18c 100644
--- a/java/jakarta/mail/PasswordAuthentication.java
+++ b/java/jakarta/mail/PasswordAuthentication.java
@@ -20,6 +20,7 @@ package jakarta.mail;
  * Stores username and password credentials for mail authentication. This 
class follows the pattern defined by
  * {@link java.net.PasswordAuthentication} and is used with {@link 
Authenticator} to provide credentials when
  * establishing mail connections.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 @SuppressWarnings("unused") // Dummy implementation
 public class PasswordAuthentication {
diff --git a/java/jakarta/mail/Session.java b/java/jakarta/mail/Session.java
index 35f221afff..dc344153f5 100644
--- a/java/jakarta/mail/Session.java
+++ b/java/jakarta/mail/Session.java
@@ -20,6 +20,7 @@ import java.util.Properties;
 
 /**
  * Represents a mail session configuration.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 @SuppressWarnings("unused") // Dummy implementation
 public class Session {
diff --git a/java/jakarta/mail/internet/InternetAddress.java 
b/java/jakarta/mail/internet/InternetAddress.java
index 5d766f5e4d..de7efb6f8a 100644
--- a/java/jakarta/mail/internet/InternetAddress.java
+++ b/java/jakarta/mail/internet/InternetAddress.java
@@ -20,6 +20,7 @@ package jakarta.mail.internet;
  * Represents an Internet email address as defined by RFC 822.
  * An Internet address consists of an optional personal name and
  * an address string in the form of local-part@domain.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 @SuppressWarnings("unused") // Dummy implementation
 public class InternetAddress {
diff --git a/java/jakarta/mail/internet/MimeMessage.java 
b/java/jakarta/mail/internet/MimeMessage.java
index 3fae2b288c..880455e808 100644
--- a/java/jakarta/mail/internet/MimeMessage.java
+++ b/java/jakarta/mail/internet/MimeMessage.java
@@ -21,6 +21,7 @@ import jakarta.mail.Session;
 /**
  * Represents a MIME message in the Jakarta Mail API.
  * Provides methods for setting message headers such as sender and subject.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 @SuppressWarnings("unused") // Dummy implementation
 public class MimeMessage implements MimePart {
diff --git a/java/jakarta/mail/internet/MimePart.java 
b/java/jakarta/mail/internet/MimePart.java
index 0be69d33e6..bd9384eef0 100644
--- a/java/jakarta/mail/internet/MimePart.java
+++ b/java/jakarta/mail/internet/MimePart.java
@@ -19,6 +19,7 @@ package jakarta.mail.internet;
 /**
  * Represents a part of a MIME message in the Jakarta Mail API.
  * A MimePart can contain content and headers for a single MIME entity.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 public interface MimePart {
     // Dummy implementation
diff --git a/java/jakarta/mail/internet/MimePartDataSource.java 
b/java/jakarta/mail/internet/MimePartDataSource.java
index 17b946b53a..9f352a0e01 100644
--- a/java/jakarta/mail/internet/MimePartDataSource.java
+++ b/java/jakarta/mail/internet/MimePartDataSource.java
@@ -19,6 +19,7 @@ package jakarta.mail.internet;
 /**
  * Provides a DataSource representation for a MimePart.
  * Wraps a MimePart so it can be used where a DataSource is required.
+ * NOTE: This is a stub API, Apache Tomcat does not provide any implementation 
for this API.
  */
 @SuppressWarnings("unused") // Dummy implementation
 public class MimePartDataSource {


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to