+ improved example to work with multi-nested declarations
+ used JDK 5 syntax
+ added documentation code into trunk (including unit test) for easier future reference

+ added table summarizing the Aware interfaces in Spring 3

+ added some clarifications
+ improved the document structure

+ replaced handleRequest() with setSynchronizeOnSession() which is final

SPR-6756

updated reference documentation with references to "spring-agent.jar" to use "org.springframework.instrument-{version}.jar" (SPR-6597)

fixed getPropertyTypeDescriptor to work for nested indexed property as well as for array property (SPR-6710)