Clarify handling of final line ending in str::lines()

I found the description as it stands a bit confusing. I've added a bit more explanation to make it clear that a trailing line ending does not produce a final empty line.

1 files changed, 3 insertions, 1 deletions

diff --git a/library/core/src/str/mod.rs b/library/core/src/str/mod.rs
index b36d9f5c388..f4e8529a58f 100644
--- a/library/core/src/str/mod.rs
+++ b/library/core/src/str/mod.rs
@@ -842,7 +842,9 @@ impl str {
     /// Lines are ended with either a newline (`\n`) or a carriage return with
     /// a line feed (`\r\n`).
     ///
-    /// The final line ending is optional.
+    /// The final line ending is optional. A string that ends with a final line
+    /// ending (carriage return or line feed) will return the same lines as an
+    /// otherwise identical string without a final line ending.
     ///
     /// # Examples
     ///