RFR: (CSR) JDK-8236688 Clarify String::stripIndent javadoc when string ends with line terminator

[Jim Laskey]

Sponsoring for Andrew Leonard. Please review the following CSR. Hopefully this 
clarifies user's misunderstanding when a line seems to disappear when the 
string ends with a line terminator. 


CSR: https://bugs.openjdk.java.net/browse/JDK-8236688
JBS: https://bugs.openjdk.java.net/browse/JDK-8230800

Thank you.

Cheers,

-- Jim