Adding @return to all method JavaDoc

JDK8 JavaDoc needs @return on all non-void methods. Unfortunetaly
Checkstyle does not know about this
(http://sourceforge.net/p/checkstyle/bugs/543/), so we have to disable
the JavaDocMethod check for now.