Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing documentation for ServiceLoader option for loading Providers #112

Closed
verhasi opened this issue Oct 5, 2023 · 1 comment
Closed
Labels
documentation Improvements or additions to documentation

Comments

@verhasi
Copy link

verhasi commented Oct 5, 2023

Describe the bug
A documentation at https://jakarta.ee/specifications/mail/2.1/jakarta-mail-spec-2.1#a240 does not mention the option of ServiceLoader to load a Provider. I see that Angus Mail is RI of the specification so this could be an issue of the specification itself. In this case my question is where I can contribute this proposal to the specifaction.
Until the specification will describe the details it would be a "workaround" to extend the java doc of the Provider at https://jakarta.ee/specifications/mail/2.1/apidocs/jakarta.mail/jakarta/mail/provider to give the details of this option.
Actually the ServiceLoader option was implemented at javaee/javamail@c4e604d five years ago.

To Reproduce
Look at the documentation and they are missing to mention this option.
https://jakarta.ee/specifications/mail/2.1/jakarta-mail-spec-2.1#a240
https://jakarta.ee/specifications/mail/2.1/apidocs/jakarta.mail/jakarta/mail/provider

Expected behavior
Add the ServiceLoader option to the documentation both in the specification and in the java doc of Provider

@lukasj
Copy link
Member

lukasj commented Feb 15, 2024

moved to jakartaee/mail-api#708

@lukasj lukasj closed this as completed Feb 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants