add javadocs that used to be in datanucleus.org docs
Merge branch 'master' of github.com:datanucleus/datanucleus-core