[aspectj-users] AspectJ (tm) Project Guide - Confusing Example

[David Lloyd <lloy0076@xxxxxxxxxxx>]

Hi There,

In the AspectJ programming guide:

http://www.eclipse.org/aspectj/doc/released/progguide/starting-aspectj.html

...a FigureEditor is used as an example.

Now, in this FigureEditor there is the concept of:

 * a POINT

The problem is that it appears that Aspect Oriented Programming (AOP) 
also uses the word POINT. Consequently at:

http://www.eclipse.org/aspectj/doc/released/progguide/starting-aspectj.html#pointcuts

...I see:

call(void Point.setX(int))

...with an explanation:

picks out each join point that is a call to a method that has the 
signature void Point.setX(int) — that is, Point's void setX  method with 
a single int parameter.

...wouldn't it have been easier if an example whose own class or jargon 
didn't clash with AOP's were chosen? Having read JBoss AOP's (clearer) 
documentation, it's obvious that a point cut doesn't need to be called 
"Point".

In a future revision of the documentation it may be useful to _consider_ 
using examples whose class names or jargon DO NOT clash with AspectJ's 
or AOP's...

DSL