Caller invocations are for use in cases where the execution pointcuts cannot be used, and this functionality is not present in the "normal" execution invocations either. In my opinion interceptors should not know anything about the caller object, but I could be convinced :-)
I'll let Bill decide if the documentation is a typo or if this is something we should add.
The first sentence should have been:
You cannot get the calling object but you can get the calling Class.
Caller invocations should be able to reference the called and calling object.
You can currently reference the called object by getTargetObject. We should add a getCallingObject method to XXXXCalledByMethod invocation classes.
I'd be satisfied with that. That's exactly what I meant.
Ok, this is implemented in CVS. It will be in next release.