Publish Javadoc to well-known location

[sbrannen]

The Spring Framework build has recently started reporting the following warning.

warning: URL https://eclipse.dev/aspectj/doc/released/aspectj5rt-api/element-list was redirected to https://projects.eclipse.org/projects/tools.aspectj

However, https://projects.eclipse.org/projects/tools.aspectj is not the location for the AspectJ Javadoc.

I apologize if I have overlooked something, but I cannot determine where the AspectJ Javadoc is currently published online.

Can you please update the project's README to point to the location where AspectJ's Javadoc is published?

For example, Spring Framework would currently need to link to the Javadoc for AspectJ 1.9.22.1.

[kriegaex]

@aclement, you have not reacted to my latest e-mail about the PHP migration f***-up which made the complete AspectJ docs (of which the javadocs are but a small part) become unaccessible due to faulty redirection. You told the Eclipse admin team how you wanted it done. Maybe, you can coordinate with them to fix it again. You know that I am on hiatus until I found a sponsor. Thank you very much.

[kriegaex]

@sbrannen, it looks as if the issue is resolved and the AspectJ documentation accessible again right from the same URLs it used to be before Eclipse deactivated PHP on its pages and a glitch happened with redirection while someone tried to work around it.

When opening https://projects.eclipse.org/projects/tools.aspectj, you find a link named "Website", leading to https://eclipse.dev/aspectj/, which is now accessible again without falsely linking back to the project page. There, you find a link "Docs", leading to https://eclipse.dev/aspectj/doc/latest/index.html. Finally, there you find links to javadocs:

• https://eclipse.dev/aspectj/doc/latest/runtime-api/index.html
• https://eclipse.dev/aspectj/doc/latest/weaver-api/index.html

The credit for fixing the problem goes to @aclement. 🙏

[kriegaex]

Reopening because the read-me needs an update. It currently contains only GitHub links, but the javadocs are published separately and cannot be accessed inline from GitHub. Links to the Eclipse project page, the AspectJ website and specifically to the docs overview page should be part of the read-me.

[sbrannen]

When opening projects.eclipse.org/projects/tools.aspectj, you find a link named "Website", leading to eclipse.dev/aspectj, which is now accessible again without falsely linking back to the project page. There, you find a link "Docs", leading to eclipse.dev/aspectj/doc/latest/index.html. Finally, there you find links to javadocs:

Thanks for the details on how to navigate through all of that. Much appreciated. Plus, I discovered the AspectJ Java version compatibility page which is handy.

And thanks for updating the GitHub README as well. 👍

The credit for fixing the problem goes to @aclement. 🙏

Indeed it does! Cheers, @aclement. 👏

FYI: Andy has also published modern Javadoc for AspectJ Runtime types here: https://eclipse.dev/aspectj/doc/released/1.9.22.1/aspectjrt/.

See also: spring-projects/spring-framework#34293

[kriegaex]

FYI: Andy has also published modern Javadoc for AspectJ Runtime types here: https://eclipse.dev/aspectj/doc/released/1.9.22.1/aspectjrt/.

Sorry, but what about it is different from the https://eclipse.dev/aspectj/doc/latest/runtime-api/ I published long ago? At first glance, it looks identical. Please enlighten me.

[sbrannen]

Sorry, but what about it is different from the eclipse.dev/aspectj/doc/latest/runtime-api I published long ago? At first glance, it looks identical. Please enlighten me.

As I mentioned in spring-projects/spring-framework#34293, the old Javadoc was for AspectJ 1.6 (2009).

The Javadoc is very different: different style, search box, element-list file instead of package-list file, and it's based on AspectJ 1.9.22.1.

[kriegaex]

@sbrannen Again: I published it long ago like this, your links simply used the old location with the legacy docs that I kept around for a while so as not to disrupt people using old links too much too quickly. The link to the element list you just used is from the version I published. It also has the search box. IMO it was completely unnecessary and redundant to publish it one more time. Just update the link and be happy. Did you compare the two aspectjrt javadocs? What is different about them?

@aclement Can you maybe explain why you re-published something that was already published and linked off of the docs overview page (see my screenshot above) for a long time?

[kriegaex]

To be exact, I added the modern javadocs for both weaver and runtime on Valentine's Day 2024, i.e. almost a year ago, see e.g. this Git file history. Last time I updated everything for 1.9.21.1, since then there have not been any changes in API docs AFAIR, so updates for 1.9.22 or 1.9.22.1 were unnecessary.