updated javadoc to the most recent semantics, main difference: 
inheritance no longer automatically propagates annotations.
3 files changed