Ensure the interface and implementation javadocs share the same warnings, and paragraph-ise to look nicer