From: Barry Warsaw <barry@python.org>
Date: Tue, 17 Jan 2006 05:24:25 +0000 (+0000)
Subject: Update email.Message.get_filename() documentation.
X-Git-Tag: v2.5a0~805
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=48653af70f4c09acf3f062a736b00a31678a6896;p=python

Update email.Message.get_filename() documentation.
---

diff --git a/Doc/lib/emailmessage.tex b/Doc/lib/emailmessage.tex
index 9059d88028..9b41852d78 100644
--- a/Doc/lib/emailmessage.tex
+++ b/Doc/lib/emailmessage.tex
@@ -435,10 +435,11 @@ When the \mailheader{Content-Type} header is set a
 
 \begin{methoddesc}[Message]{get_filename}{\optional{failobj}}
 Return the value of the \code{filename} parameter of the
-\mailheader{Content-Disposition} header of the message, or \var{failobj} if
-either the header is missing, or has no \code{filename} parameter.
-The returned string will always be unquoted as per
-\method{Utils.unquote()}.
+\mailheader{Content-Disposition} header of the message.  If the header does
+not have a \code{filename} parameter, this method falls back to looking for
+the \code{name} parameter.  If neither is found, or the header is missing,
+then \var{failobj} is returned.  The returned string will always be unquoted
+as per \method{Utils.unquote()}.
 \end{methoddesc}
 
 \begin{methoddesc}[Message]{get_boundary}{\optional{failobj}}