Bug 66542 - JavaMail specification links are outdated in documentation
Summary: JavaMail specification links are outdated in documentation
Alias: None
Product: Tomcat 10
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 10.1.7
Hardware: PC All
: P2 normal (vote)
Target Milestone: ------
Assignee: Tomcat Developers Mailing List
Depends on:
Reported: 2023-03-24 00:26 UTC by Konstantin Kolinko
Modified: 2023-03-27 19:09 UTC (History)
0 users


Note You need to log in before you can comment on or make changes to this bug.
Description Konstantin Kolinko 2023-03-24 00:26:37 UTC

Looking at "JNDI Resources How-To" document of Tomcat 10.1.7, at its section titled "JavaMail Sessions".

This section was updated to use a Jakarta EE package name (using "jakarta.mail.Session" etc.), but links reference old Java EE implementation of the API.

1. At "0. Introduction" 

"The Java Mail API" links to http://www.oracle.com/technetwork/java/javamail/index.html

2. At "4. Install the JavaMail libraries"

"Download the JavaMail API." links to http://javamail.java.net/  that redirects to "https://javaee.github.io/javamail/". A footer on that web site says "This project is now part of the EE4J initiative; its activity is temporarily paused until it has been effectively transferred to the Eclipse Foundation.".

I think that the relevant specification is here:


Not tested.
Comment 1 Konstantin Kolinko 2023-03-24 00:45:18 UTC
> https://jakarta.ee/specifications/mail/

Note that a Jakarta EE specification is just an API. One needs an implementation of the spec.

The "Jakarta Mail 2.1" specification page references the following project as a "Compatible Implementation":

Eclipse Angus - Mail

(There may be other compatible implementations as well, not listed at the specification page.)
Comment 2 Mark Thomas 2023-03-27 19:09:07 UTC
Fixed in:
- 11.0.x for 11.0.0-M5 onwards
- 10.1.x for 10.1.8 onwards