Update javadoc tag to new scaladoc tags.

review @vladureche 

https://issues.scala-lang.org/browse/SI-6144
It looks like you copy-pasted this code from `DocComments.scala`, but forgot to remove the code there. Would it be possible to remove one copy or the other? The DRY (= Don't Repeat Yourself) principle says we should only have one copy of the method.