Bug 518705 - AspectJ documentation should cover annotations
Summary: AspectJ documentation should cover annotations
Status: NEW
Alias: None
Product: AspectJ
Classification: Tools
Component: Docs (show other bugs)
Version: unspecified   Edit
Hardware: All All
: P3 major (vote)
Target Milestone: ---   Edit
Assignee: aspectj inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-06-23 09:17 EDT by Roland Illig CLA
Modified: 2017-06-23 11:51 EDT (History)
1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Roland Illig CLA 2017-06-23 09:17:46 EDT 
https://eclipse.org/aspectj/doc/released/progguide/semantics-pointcuts.html#pattern-summary

The section "Pattern Summary" lists some grammar rules, but these rules don't mention annotations at all, although these are part of the grammar since more than 10 years.

Since the progguide has probably not been touched since 2003, it should not be listed at all on the page https://eclipse.org/aspectj/doc/released/index.html.

Also, on https://eclipse.org/aspectj/docs.php, mentioning "AspectJ 5" although the current version is 1.8 looks rather antique.
Comment 1 Andrew Clement CLA 2017-06-23 11:51:53 EDT 
I won't deny the docs need a refresh, but all the annotation related material is in the AspectJ developers notebook if that is what you are looking for:

https://eclipse.org/aspectj/doc/next/adk15notebook/

After that I'm afraid changes since then are catalogued across all the readmes with each release, they haven't been folded into the mainline docs (very overdue also).