From: Barry Warsaw <barry@python.org>
Date: Tue, 17 Jan 2006 05:29:56 +0000 (+0000)
Subject: Update documentation for email.Message.get_filename().
X-Git-Tag: v2.4.3c1~132
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e87ccea16253c50ee9c24bd9ba4622c0bdfae2c6;p=thirdparty%2FPython%2Fcpython.git

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

diff --git a/Doc/lib/emailmessage.tex b/Doc/lib/emailmessage.tex
index 9059d8802800..9b41852d78b3 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}}