[
https://issues.apache.org/jira/browse/MAILET-24?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12680857#action_12680857
]
Willis Blackburn commented on MAILET-24:
----------------------------------------
I'm not suggesting that you remove the methods. I'm saying that you should
update the documentation so that people know not to use these methods with
James 2.3.1. The documentation says that the only differences between mailet
2.3 and 2.4 are "minor bug fixes" when that is obviously not true: there are
new methods!
Suggestion: Update the Javadocs for the methods with @since 2.4 so people know
they're new, and change the page to say something like "2.4 differs from the
last version shipped (with Server 2.3) by the addition of minor bug fixes and
some new methods. These methods, marked @since 2.4, must be avoided if you
want your mailet to run with Server 2.3. Some of the new methods replace
methods that are now deprecated."
Here's another suggestion: Just release a version 2.3 of mailet that
duplicates the mailet API included in server 2.3 exactly, so that people can
use it instead of mailet 2.4 if they want to run with server 2.3.
> Mailet 2.4 claim about backward-compatibility is wrong
> ------------------------------------------------------
>
> Key: MAILET-24
> URL: https://issues.apache.org/jira/browse/MAILET-24
> Project: Mailet
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 2.4
> Reporter: Willis Blackburn
>
> The documentation claims: "2.4 differs from the last version shipped (with
> Server 2.3) only by minor bug fixes and is compatible with it."
> It took me several hours to discover that the statement is incorrect. Mailet
> 2.4's MailAddress class includes the methods getDomain and getLocalPart.
> These methods do not exist in the Mailet 2.3 API that ships with the James
> 2.3.1 server.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
