correct and clarify str.splitlines() documentation

Doc/library/stdtypes.rst

 .. XXX: reference/datamodel and this have quite a few overlaps!
 
 
 .. _bltin-types:
 
 **************
 Built-in Types
 **************
 
 The following sections describe the standard types that are built into the
@@ skipping 1333 matching lines @@
    string has leading or trailing whitespace.  Consequently, splitting an empty
    string or a string consisting of just whitespace with a ``None`` separator
    returns ``[]``.
 
    For example, ``' 1  2   3  '.split()`` returns ``['1', '2', '3']``, and
    ``'  1  2   3  '.split(None, 1)`` returns ``['1', '2   3  ']``.
 
 
 .. method:: str.splitlines([keepends])
 
-   Return a list of the lines in the string, breaking at line boundaries.  Line
-   breaks are not included in the resulting list unless *keepends* is given and
-   true. This method uses the universal newlines approach to splitting lines.
-   Unlike :meth:`~str.split`, if the string ends with line boundary characters
-   the returned list does ``not`` have an empty last element.
+   Return a list of the lines in the string, breaking at line boundaries.
+   This method uses the universal newlines approach to splitting lines.
+   Line breaks are not included in the resulting list unless *keepends* is
+   given and true.
 
    For example, ``'ab c\n\nde fg\rkl\r\n'.splitlines()`` returns
    ``['ab c', '', 'de fg', 'kl']``, while the same call with ``splitlines(True)``
    returns ``['ab c\n', '\n, 'de fg\r', 'kl\r\n']``.
 
+   Unlike :meth:`~str.split` when a delimiter string *sep* is given, this
+   method returns an empty list for the empty string, and a terminal line
+   break does not result in an extra line.
+
 
 .. method:: str.startswith(prefix[, start[, end]])
 
    Return ``True`` if string starts with the *prefix*, otherwise return ``False``.
    *prefix* can also be a tuple of prefixes to look for.  With optional *start*,
    test string beginning at that position.  With optional *end*, stop comparing
    string at that position.
 
 
 .. method:: str.strip([chars])
@@ skipping 1748 matching lines @@
 .. [2] As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, and
    similarly for tuples.
 
 .. [3] They must have since the parser can't tell the type of the operands.
 
 .. [4] Cased characters are those with general category property being one of
    "Lu" (Letter, uppercase), "Ll" (Letter, lowercase), or "Lt" (Letter, titlecase).
 
 .. [5] To format only a tuple you should therefore provide a singleton tuple whose only
    element is the tuple to be formatted.