ScalaDoc incorrectly treats dot in acronym (such as i.e.) as end of sentence

[scabug]

The ScalaDoc is supposed to show the first sentence about a member as its summary. 2.11.2 fixed a bug where the first period found was treated as a sentence end (#8672). A similar bug still occurs with acronyms ending in a period, such as "i.e.".

http://www.scala-lang.org/api/2.11.2/index.html#scala.concurrent.Future

The first line of Future.onSuccess shown is

When this future is completed successfully (i.e.

It should show instead

When this future is completed successfully (i.e. with a value), apply the provided partial function to the value if the partial function is defined at that value.

[scabug]

Imported From: https://issues.scala-lang.org/browse/SI-8839?orig=1
Reporter: Kevin Song (kxsong)
Affected Versions: 2.11.2

[scabug]

@som-snytt said:
Actually, that's not an acronym, as my colleague would insist, and second:

scala/scala#3918

recognizes that the parenthetical should be set off with a comma.

(Apparently, C.I.A. is an initialism and scuba and laser are acronyms.)

That means initialisms are disallowed in the first sentence, however. Except at the end, of course; Y.M.M.V.

http://www.scala-lang.org/files/archive/nightly/2.11.x/api/2.11.x/index.html#scala.concurrent.Future@onSuccess[U](pf:PartialFunction[T,U])(implicitexecutor:scala.concurrent.ExecutionContext):Unit

[scabug]

Kevin Song (kxsong) said:
Thanks, I didn't see this commit in the issue tracker, should have checked the nightly build ScalaDoc as well.

I have very little experience with the scala-lang source (let alone Scala), but would it make more sense to ignore initialisms in checkSentenceEnded() (through, say, checking capitalization after a period) instead of requiring each initialism to be followed by a comma? From a prose perspective, proper capitalization is more straightforward than remembering a comma.