Bug #1011: fix rfc822.Message.getheader docs.

diff --git a/Doc/library/rfc822.rst b/Doc/library/rfc822.rst
index 52df0130bf41befff5944ed1895ba5d29c60a92b..da9f536461a9a39afe6dbd6da6e552cea623acf3 100644 (file)
--- a/Doc/library/rfc822.rst
+++ b/Doc/library/rfc822.rst
@@ -198,10 +198,12 @@ A :class:`Message` instance has the following methods:
 
 .. method:: Message.getheader(name[, default])
 
-   Like ``getrawheader(name)``, but strip leading and trailing whitespace.
+   Return a single string consisting of the last header matching *name*,
+   but strip leading and trailing whitespace.
    Internal whitespace is not stripped.  The optional *default* argument can be
    used to specify a different default to be returned when there is no header
-   matching *name*.
+   matching *name*; it defaults to ``None``.
+   This is the preferred way to get parsed headers.
 
 
 .. method:: Message.get(name[, default])