summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorSean Reifscheider <jafo@tummy.com>2007-09-18 23:39:35 (GMT)
committerSean Reifscheider <jafo@tummy.com>2007-09-18 23:39:35 (GMT)
commit782d6b44a1cc003106bac3a310d3e4ac3768adbd (patch)
tree5050dbca3ae364efe90d402dd795e5179afc92f7 /Doc/library
parentc2504931ee6bb19b4d38d0d654b02a6fbc797ebd (diff)
downloadcpython-782d6b44a1cc003106bac3a310d3e4ac3768adbd.zip
cpython-782d6b44a1cc003106bac3a310d3e4ac3768adbd.tar.gz
cpython-782d6b44a1cc003106bac3a310d3e4ac3768adbd.tar.bz2
issue1172: Documentation of "done" attribute in cgi module.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/cgi.rst5
1 files changed, 5 insertions, 0 deletions
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.