SI-8672 Better end-of-sentence detection for Scaladoc

The first sentence of a Scaladoc comment is parsed as the summary.
However, this was breaking of the sentence at the first `.`, even
if that was immediately followed by another character.

This commit only considers a period followed by whitespace, EOL or
EOF as the end of a sentence.

2 files changed, 36 insertions, 0 deletions

diff --git a/test/scaladoc/run/t8672.check b/test/scaladoc/run/t8672.check
new file mode 100644
index 0000000000..d7194c73bf
--- /dev/null
+++ b/test/scaladoc/run/t8672.check
@@ -0,0 +1,4 @@
+Some(Chain(List(Text(New in release 1.2.3.4, it works), Text(.))))
+Some(Text(Sentence no period))
+Some(Chain(List(Text(Sentence period at end), Text(.))))
+Done.
diff --git a/test/scaladoc/run/t8672.scala b/test/scaladoc/run/t8672.scala
new file mode 100644
index 0000000000..8a9b5086bd
--- /dev/null
+++ b/test/scaladoc/run/t8672.scala
@@ -0,0 +1,32 @@
+import scala.tools.nsc.doc.model._
+import scala.tools.partest.ScaladocModelTest
+
+object Test extends ScaladocModelTest {
+  override def code = """
+  class C {
+    
+    /**
+     * New in release 1.2.3.4, it works. Next sentence.
+     * Next Line.
+     */
+    def method1 = 0
+
+    /** Sentence no period */
+    def method2 = 0
+
+    /** Sentence period at end.*/
+    def method3 = 0
+  }
+  """
+
+  def scaladocSettings = ""
+
+  def testModel(root: Package) = {
+    import access._
+    val ms = List("method1", "method2", "method3")
+    for (m <- ms) {
+      val method = root._class("C")._method(m)
+      println(method.comment.get.body.summary)  
+    }
+  }
+}