Scaladoc permits inheritDoc with different parameter names

[som-snytt]

Compiler version

3.3

Minimized code

mutable.HashMap#getOrElseUpdate renames parameter ops to defaultValue, but inheritDoc does not warn or adjust.

Output

Dottydoc improves on Scaladoc 2, which simply omits the spurious param.

Expectation

It would be nice to get a warning (I didn't actually check whether Dottydoc warns) or fix up the name @param name. (References in the doc text would require edits.)

Scaladoc 2 also does not cope.

[som-snytt]

More generally, dottydoc does not check the @param name. Noticed when I @deprecatedName: I fixed the compilation error with the new name, but there was no doc warning or error. (It would be fine to support correlating a deprecated name.)

[som-snytt]

If anyone is thinking of fixing this (and if it's still an issue), the original symptom was fixed in mutable.Map by

 def getOrElseUpdate(key: K, @deprecatedName("op", since="2.13.13") defaultValue: => V): V