Updated docs for email.Message.get_filename()

warsaw · warsaw · commit 9b55f08ceaf6 · 2006-01-17T05:17:29.000Z
diff --git a/Doc/lib/emailmessage.tex b/Doc/lib/emailmessage.tex
@@ -431,10 +431,11 @@
 
 \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}}
