config/5099: common problems on Windows NT not described in documentation

[Tomas Hulek <th...@cz.ibm.com>]

>Number:         5099
>Category:       config
>Synopsis:       common problems on Windows NT not described in documentation
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    apache
>State:          open
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Mon Oct  4 09:40:01 PDT 1999
>Last-Modified:
>Originator:     thulek@cz.ibm.com
>Organization:
apache
>Release:        1.3.9
>Environment:
Windows NT - precompiled binaries
>Description:
I believe that many people using Windows NT would have much easier time (and would fall in love with Apache sooner) if the installation, documentation and sample configuration would show how to avoid the most common problems.
>How-To-Repeat:

>Fix:
Almost everyone on Windows NT will run into these problems:

1) The directive setting 'ScriptInterpreterSource registry' is almost always needed, yet this directive is neither mentioned in default httpd.conf, nor in the 'htdocs\manual\windows.html' page.

It takes quite some time for the newcomer to Apache to discover what is wrong with CGI programs not using sheebang.

2) I understand that there are reasons for CGI scripts not to inherit automatically all environmental vars from the server.  However, the variables that are inherited by default almost never enough.

Ideally, there should be a note in the windows.html document and in the default httpf.conf how to pass on other vars.

For example, things like CLASSPATH, TEMP, TMP will be needed by almost everyone.
>Audit-Trail:
>Unformatted:
[In order for any reply to be added to the PR database, you need]
[to include <ap...@Apache.Org> in the Cc line and make sure the]
[subject line starts with the report component and number, with ]
[or without any 'Re:' prefixes (such as "general/1098:" or      ]
["Re: general/1098:").  If the subject doesn't match this       ]
[pattern, your message will be misfiled and ignored.  The       ]
["apbugs" address is not added to the Cc line of messages from  ]
[the database automatically because of the potential for mail   ]
[loops.  If you do not include this Cc, your reply may be ig-   ]
[nored unless you are responding to an explicit request from a  ]
[developer.  Reply only with text; DO NOT SEND ATTACHMENTS!     ]