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

1 files changed, 36 insertions, 2 deletions

diff --git a/Doc/lib/libcgi.tex b/Doc/lib/libcgi.tex
index 54fbd69..1c565fd 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}