diff options
author | Jason Zaugg <jzaugg@gmail.com> | 2014-06-20 10:56:12 +0200 |
---|---|---|
committer | Jason Zaugg <jzaugg@gmail.com> | 2014-06-20 10:56:12 +0200 |
commit | 2238a85d732dbfd63cfd9910511aa140838933f7 (patch) | |
tree | 6b4c161d8fdc70d301cb3d823b9e12f2a50aed2c /test/scaladoc/run | |
parent | b664a488acca9d89c600f5b87ba9a9ca77aace59 (diff) | |
download | scala-2238a85d732dbfd63cfd9910511aa140838933f7.tar.gz scala-2238a85d732dbfd63cfd9910511aa140838933f7.tar.bz2 scala-2238a85d732dbfd63cfd9910511aa140838933f7.zip |
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.
Diffstat (limited to 'test/scaladoc/run')
-rw-r--r-- | test/scaladoc/run/t8672.check | 4 | ||||
-rw-r--r-- | test/scaladoc/run/t8672.scala | 32 |
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) + } + } +} |