summaryrefslogtreecommitdiffstats
path: root/Doc/library/cgi.rst
diff options
context:
space:
mode:
authorSean Reifscheider <jafo@tummy.com>2007-09-18 23:34:44 (GMT)
committerSean Reifscheider <jafo@tummy.com>2007-09-18 23:34:44 (GMT)
commit111c0ea34a3308a99589704f6f156185d192b5f4 (patch)
tree9cc31d470ceddf02f6803a1068219ead8e990b9b /Doc/library/cgi.rst
parentbbaff4c7e8de61a80b1ab77602e83b5a030d380a (diff)
downloadcpython-111c0ea34a3308a99589704f6f156185d192b5f4.zip
cpython-111c0ea34a3308a99589704f6f156185d192b5f4.tar.gz
cpython-111c0ea34a3308a99589704f6f156185d192b5f4.tar.bz2
issue1172: Documentation of "done" attribute in cgi module.
Diffstat (limited to 'Doc/library/cgi.rst')
-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 29ed545..6b2e3d2 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.