From 782d6b44a1cc003106bac3a310d3e4ac3768adbd Mon Sep 17 00:00:00 2001 From: Sean Reifscheider Date: Tue, 18 Sep 2007 23:39:35 +0000 Subject: issue1172: Documentation of "done" attribute in cgi module. --- Doc/library/cgi.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/library/cgi.rst b/Doc/library/cgi.rst index 86b8c47..41ebf9d 100644 --- a/Doc/library/cgi.rst +++ b/Doc/library/cgi.rst @@ -147,6 +147,11 @@ attribute:: if not line: break linecount = linecount + 1 +If an error is encountered when obtaining the contents of an uploaded file +(for example, when the user interrupts the form submission by clicking on +a Back or Cancel button) the :attr:`done` attribute of the object for the +field will be set to the value -1. + The file upload draft standard entertains the possibility of uploading multiple files from one field (using a recursive :mimetype:`multipart/\*` encoding). When this occurs, the item will be a dictionary-like :class:`FieldStorage` item. -- cgit v0.12