Refactored example to Option.collect method.
Fixes cut sentences in the generated scaladocs

This commit changes all first sentences of library functions which
contain `i.e.` or `e.g.` and adds a `,` to prevent that the scaladoc
summary sentence is cut after this abbreviation.

This is possible as pull/3824 fixed how Scaladoc parses the first
sentence of a method description into a sumary sentence(now the first
sentence has to end with a dot followed by whitespace).

Only docs in the core library are changed (src/library/**/*.scala)
and only if they occur in the first sentence.

Review by @heathermiller
Merge pull request #3898 from adriaanm/jxcoder-issue-3861

Refactored example to Option.collect method.
Merge pull request #3918 from dgruntz/doc/firstSentenceFixes

Fixes cut sentences in the generated scaladocs
Modified Range.Double to use NumericRange of Double instead of using BigDecimal internally and then converting it to Double.