From dade07032782e35059c9fd30962c769923d0ad24 Mon Sep 17 00:00:00 2001 From: Matt Raible Date: Tue, 28 Jul 2026 12:47:50 -0600 Subject: [PATCH] Update install guide with working JavaMail download links The JavaMail download link pointed to https://java.net/projects/javamail which no longer exists. Updated to provide direct Maven Central links for jakarta.mail and jakarta.activation JARs, and explained why the dependency is required even without email features (Roller uses the JavaMail API for email address validation in core code). Also updated the SMTP package Javadoc link to the current Eclipse project URL. --- docs/roller-install-guide.adoc | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/roller-install-guide.adoc b/docs/roller-install-guide.adoc index cf81b801f..89e620e19 100644 --- a/docs/roller-install-guide.adoc +++ b/docs/roller-install-guide.adoc @@ -479,7 +479,7 @@ password in 'mail/Session' Resource. ---- The Java mail properties listed above are defined here: -https://javamail.java.net/nonav/docs/api/com/sun/mail/smtp/package-summary.html. +https://eclipse-ee4j.github.io/mail/docs/api/com/sun/mail/smtp/package-summary.html. Note the email account defined above will appear in the "From:" line of notification email messages sent to blog owners (and, if they select "Notify me of further comments", blog commenters) so take care not to @@ -523,9 +523,12 @@ subsystem will be able to find and use them. Download them from your database vendor/provider and place them in Tomcat’s _lib_ directory. * **Java Mail and Activation. **Tomcat does not include the Java Mail and Activation jars. Even if you do not plan to use email features, you -must download those jars and place them in Tomcat’s classpath. Download -them from Oracle (https://java.net/projects/javamail/pages/Home) and -place them in Tomcat’s _lib_ directory. +must download those jars and place them in Tomcat’s classpath because +Roller uses the JavaMail API for email address validation in its core +code. Download them from Maven Central and place them in Tomcat’s _lib_ +directory: +** https://repo1.maven.org/maven2/com/sun/mail/jakarta.mail/1.6.7/jakarta.mail-1.6.7.jar[jakarta.mail-1.6.7.jar] +** https://repo1.maven.org/maven2/com/sun/activation/jakarta.activation/1.2.2/jakarta.activation-1.2.2.jar[jakarta.activation-1.2.2.jar] === Tomcat: Set URI Encoding