copying over recent javadoc enhancements from the 0.20 branch
#1607 wiping the javadoc @since slate clean for 1.0