]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Updated docs for email.Message.get_filename()
authorBarry Warsaw <barry@python.org>
Tue, 17 Jan 2006 05:17:29 +0000 (05:17 +0000)
committerBarry Warsaw <barry@python.org>
Tue, 17 Jan 2006 05:17:29 +0000 (05:17 +0000)
Doc/lib/emailmessage.tex

index dbd1afd649d35a68c06e949cebcfd66e7bc867bd..8263cbc07f5483191d54bf7568cc6ea305836d7d 100644 (file)
@@ -431,10 +431,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}}