[New-bugs-announce] [issue10906] wsgiref should mention that CGI scripts usually expect HTTPS variable to be set to 'on'

[anatoly techtonik]

New submission from anatoly techtonik <techtonik at gmail.com>:

http://docs.python.org/library/wsgiref.html#wsgiref.util.guess_scheme

The documentation says servers typically set HTTPS variable to a value of “1” or “yes”, when a request is received via SSL, but CGI tutorials, IIS and Apache set this to “on”.

Misleading documentation may be the reason of the bug with mod_wsgi that changes Apache's variable from “on” to “1” - https://issues.apache.org/bugzilla/show_bug.cgi?id=50581

The documentation should at least stress that “on” is the mainstream value for this variable. It will help to mention at least one popular server that returns “1”.

----------
assignee: docs at python
components: Documentation
messages: 126263
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: wsgiref should mention that CGI scripts usually expect HTTPS variable to be set to 'on'
versions: Python 3.2

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10906>
_______________________________________