improve docblocks
Merge branch 'master' into maven