From: Guido van Rossum <guido@python.org>
Date: Thu, 10 Jun 1999 03:11:41 +0000 (+0000)
Subject: Patch by Jim Fulton to document the new parse_qls().
X-Git-Tag: v1.6a1~1255
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=66ab4e8af269c7b4f579a05e8c45990726bfaf00;p=thirdparty%2FPython%2Fcpython.git

Patch by Jim Fulton to document the new parse_qls().
---

diff --git a/Doc/lib/libcgi.tex b/Doc/lib/libcgi.tex
index 54fbd69782b3..1c565fd4cbb4 100644
--- a/Doc/lib/libcgi.tex
+++ b/Doc/lib/libcgi.tex
@@ -191,9 +191,43 @@ Parse a query in the environment or from a file (default
 \code{sys.stdin}).
 \end{funcdesc}
 
-\begin{funcdesc}{parse_qs}{qs}
+\begin{funcdesc}{parse_qs}{qs\optional{, keep_blank_values, strict_parsing}}
 Parse a query string given as a string argument (data of type 
-\mimetype{application/x-www-form-urlencoded}).
+\mimetype{application/x-www-form-urlencoded}).  Data are
+returned as a dictionary.  The dictionary keys are the unique query
+variable names and the values are lists of vales for each name.
+
+The optional argument \var{keep_blank_values} is
+a flag indicating whether blank values in
+URL encoded queries should be treated as blank strings.  
+A true value indicates that blanks should be retained as 
+blank strings.  The default false value indicates that
+blank values are to be ignored and treated as if they were
+not included.
+
+The optional argument \var{strict_parsing} is a flag indicating what
+to do with parsing errors.  If false (the default), errors
+are silently ignored.  If true, errors raise a ValueError
+exception.
+\end{funcdesc}
+
+\begin{funcdesc}{parse_qsl}{qs\optional{, keep_blank_values, strict_parsing}}
+Parse a query string given as a string argument (data of type 
+\mimetype{application/x-www-form-urlencoded}).  Data are
+returned as a list of name, value pairs.
+
+The optional argument \var{keep_blank_values} is
+a flag indicating whether blank values in
+URL encoded queries should be treated as blank strings.  
+A true value indicates that blanks should be retained as 
+blank strings.  The default false value indicates that
+blank values are to be ignored and treated as if they were
+not included.
+
+The optional argument \var{strict_parsing} is a flag indicating what
+to do with parsing errors.  If false (the default), errors
+are silently ignored.  If true, errors raise a ValueError
+exception.
 \end{funcdesc}
 
 \begin{funcdesc}{parse_multipart}{fp, pdict}