Author berker.peksag
Recipients berker.peksag, docs@python, xwhhsprings
Date 2016-08-06.11:47:16
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1470484036.68.0.473529168853.issue24626@psf.upfronthosting.co.za>
In-reply-to
Content
Thanks for the report!

The default values of fp and environ parameters are already documented in the function signature in Python 3:

    cgi.parse(fp=None, environ=os.environ, keep_blank_values=False, strict_parsing=False)

In Python 2, the function signature is:

    cgi.parse(fp[, environ[, keep_blank_values[, strict_parsing]]])

Since the default values cannot be documented in the latter form, we need to specify them separately in plain text.

The reason why "(the file defaults to ``sys.stdin``)" is still in Python 3 documentation is because of the following two lines in cgi.parse() implementation:

    if fp is None:
        fp = sys.stdin

So if you invoke cgi.parse() (which means fp is None) it will be replaced with sys.stdin.
History
Date User Action Args
2016-08-06 11:47:16berker.peksagsetrecipients: + berker.peksag, docs@python, xwhhsprings
2016-08-06 11:47:16berker.peksagsetmessageid: <1470484036.68.0.473529168853.issue24626@psf.upfronthosting.co.za>
2016-08-06 11:47:16berker.peksaglinkissue24626 messages
2016-08-06 11:47:16berker.peksagcreate