[scaladoc] A warning is printed when usecase members have different n…

…ames than the real member being commented. Review by odersky. Contributed by Pedro Furlanetto.

git-svn-id: http://lampsvn.epfl.ch/svn-repos/scala/scala/trunk@22362 5e8d7ff9-d8ef-0310-90f0-a4852d11357a

src/compiler/scala/tools/nsc/typechecker/Typers.scala

@@ -3754,12 +3754,17 @@ trait Typers { self: Analyzer =>
             docComments(sym) = comment
             comment.defineVariables(sym)
             val typer1 = newTyper(context.makeNewScope(tree, context.owner))
-            for (useCase <- comment.useCases) 
+            for (useCase <- comment.useCases) {
               typer1.silent(_.typedUseCase(useCase)) match {
                 case ex: TypeError =>
                   unit.warning(useCase.pos, ex.msg)
                 case _ =>
               }
+              useCase.defined foreach { symbol =>
+                if (sym.name.toString != symbol.name.toString)
+                  unit.warning(useCase.pos, "@usecase "+symbol.name+" does not match commented symbol: "+sym.name)
+              }
+            }
           }
           typed(defn, mode, pt)