Add unbound placeholder parameter message.

Author: rubenpieters

src/dotty/tools/dotc/parsing/Parsers.scala

@@ -334,7 +334,7 @@ object Parsers {
       try op
       finally {
         placeholderParams match {
-          case vd :: _ => syntaxError("unbound placeholder parameter", vd.pos)
+          case vd :: _ => syntaxError(UnboundPlaceholderParameter(), vd.pos)
           case _ =>
         }
         placeholderParams = savedPlaceholderParams

src/dotty/tools/dotc/reporting/diagnostic/messages.scala

@@ -400,4 +400,60 @@ object messages {
            |  ((${nestedRepresentation}))""".stripMargin
     }
   }
+
+  case class UnboundPlaceholderParameter()(implicit ctx:Context)
+    extends Message(14) {
+    val kind = "Syntax"
+
+    val msg = hl"unbound placeholder parameter; incorrect use of `_`"
+
+    val codeUnboundInBlock =
+      """
+        |{ _ }
+      """.stripMargin
+
+    val codeBoundInBlock =
+      """
+        |x => { x }
+      """.stripMargin
+
+    val codeUnboundVal =
+      """
+        |val a = _
+      """.stripMargin
+
+    val codeVar =
+      """
+        |var a = _
+      """.stripMargin
+
+    val explanation =
+      hl"""The `_` placeholder syntax was used where it could not be bound.
+        |Consider explicitly writing the variable binding.
+        |
+        |This can be done by replacing `_` with a variable (eg. `x`)
+        |and adding ${"x =>"} where applicable.
+        |
+        |Example before:
+        |
+        |$codeUnboundInBlock
+        |
+        |Example after:
+        |
+        |$codeBoundInBlock
+        |
+        |Another common occurrence for this error is defining a val with `_`:
+        |
+        |$codeUnboundVal
+        |
+        |But this val definition isn't very useful, it can never be assigned
+        |another value. And thus will always remain uninitialized.
+        |Consider replacing the ${"val"} with ${"var"}:
+        |
+        |$codeVar
+        |
+        |Note that this use of `_` is not placeholder syntax,
+        |but an uninitialized var definition
+        """.stripMargin
+  }
 }