bpo-23952: Document cgi module's maxlen variable (GH-30338)

diff --git a/Doc/library/cgi.rst b/Doc/library/cgi.rst
index c151f04dfb8d01b06b7b1ad169f2b1e8fd22b22c..a2957ba5a68ad02485a9cdb7a274eea31ad62f5f 100644 (file)
--- a/Doc/library/cgi.rst
+++ b/Doc/library/cgi.rst
@@ -21,6 +21,11 @@ Support module for Common Gateway Interface (CGI) scripts.
 This module defines a number of utilities for use by CGI scripts written in
 Python.
 
+The global variable ``maxlen`` can be set to an integer indicating the maximum
+size of a POST request. POST requests larger than this size will result in a
+:exc:`ValueError` being raised during parsing. The default value of this
+variable is ``0``, meaning the request size is unlimited.
+
 
 Introduction
 ------------

diff --git a/Lib/cgi.py b/Lib/cgi.py
index 6cb8cf28bd66457ef05a8cc19bb53b8f2afbb780..22897a14a9c12202575d809a23c21c8a3e7b7771 100755 (executable)
--- a/Lib/cgi.py
+++ b/Lib/cgi.py
@@ -13,6 +13,11 @@
 
 This module defines a number of utilities for use by CGI scripts
 written in Python.
+
+The global variable maxlen can be set to an integer indicating the maximum size
+of a POST request. POST requests larger than this size will result in a
+ValueError being raised during parsing. The default value of this variable is 0,
+meaning the request size is unlimited.
 """
 
 # History