bug [ 1252706 ] poplib list() docstring fix (and docs too)

Doc/lib/libpoplib.tex

@@ -108,8 +108,8 @@ Get mailbox status.  The result is a tuple of 2 integers:
 
 \begin{methoddesc}{list}{\optional{which}}
 Request message list, result is in the form
-\code{(\var{response}, ['mesg_num octets', ...])}.  If \var{which} is
-set, it is the message to list.
+\code{(\var{response}, ['mesg_num octets', ...], \var{octets})}.
+If \var{which} is set, it is the message to list.
 \end{methoddesc}
 
 \begin{methoddesc}{retr}{which}

Lib/poplib.py

@@ -219,7 +219,7 @@ class POP3:
         """Request listing, return result.
 
         Result without a message number argument is in form
-        ['response', ['mesg_num octets', ...]].
+        ['response', ['mesg_num octets', ...], octets].
 
         Result when a message number argument is given is a
         single response: the "scan listing" for that message.