Added section on CGI usage in non-ScriptAliased directories.

Submitted by:	Marc Slemko

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@77840 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/misc/FAQ.html b/docs/manual/misc/FAQ.html
index f448403e3676389bea543dd734894a7c933bc8c1..fccffb6e785fa1b66f0346a2ce4958194d0f5227 100644 (file)
--- a/docs/manual/misc/FAQ.html
+++ b/docs/manual/misc/FAQ.html
@@ -8,7 +8,7 @@
 <!--#include virtual="header.html" -->
 <H1>Apache Server Frequently Asked Questions</H1>
 <P>
-$Revision: 1.15 $ ($Date: 1997/04/09 19:23:02 $)
+$Revision: 1.16 $ ($Date: 1997/04/11 03:25:04 $)
 </P>
 <H2>The Questions</H2>
 <!-- Stuff to Add:                                                 -->
@@ -23,6 +23,8 @@ $Revision: 1.15 $ ($Date: 1997/04/09 19:23:02 $)
 <!-- - disable Apache buffering of script output by using nph-     -->
 <!-- - access control based on DNS name really needs MAXIMUM_DNS    -->
 <!--   and double-check that rDNS resolves to name expected        -->
+<!-- - add stuff about using XBitHack Full to generate a           -->
+<!--   Last-Modified header [section on caching SSL]               -->
 <UL>
  <LI><STRONG>Background</STRONG>
   <OL START=1>
@@ -57,6 +59,9 @@ $Revision: 1.15 $ ($Date: 1997/04/09 19:23:02 $)
    <LI><A HREF="#compatible">How compatible is Apache with my existing
     NCSA 1.3 setup?</A>
    </LI>
+   <LI><A HREF="#CGIoutsideScriptAlias">How do I enable CGI execution
+        in directories other than the ScriptAlias?</A>
+   </LI>
    <LI><A HREF="#premature-script-headers">What does it mean when my
         CGIs fail with &quot;Premature end of script headers&quot;?</A>
    </LI>
@@ -365,6 +370,50 @@ $Revision: 1.15 $ ($Date: 1997/04/09 19:23:02 $)
   </P>
   <HR>
  </LI>
+ <LI><A
+      NAME="CGIoutsideScriptAlias"
+     ><STRONG>How do I enable CGI execution in directories other than
+      the ScriptAlias?</STRONG></A>
+  <P>
+  </P>
+  <P>
+  Apache recognises all files in a directory named as a
+  <A
+   HREF="../mod/mod_alias.html#scriptalias"
+  >ScriptAlias</A>
+  as being eligible for execution rather than processing as normal
+  documents.  This applies regardless of the file name, so scripts in a
+  ScriptAlias directory don't need to be named
+  &quot;<SAMP>*.cgi</SAMP>&quot; or &quot;<SAMP>*.pl</SAMP>&quot; or
+  whatever.  In other words, <EM>all</EM> files in a ScriptAlias
+  directory are scripts, as far as Apache is concerned.
+  </P>
+  <P>
+  To persuade Apache to execute scripts in other locations, such as in
+  directories where normal documents may also live, you must tell it how
+  to recognise them - and also that it's okey to execute them.
+  </P>
+  <OL>
+   <LI>In an appropriate section of your server configuration files, add
+    a line such as
+    <PRE>
+     <A
+      HREF="../mod/mod_mime.html#addhandler"
+     >AddHandler</A> cgi-script .cgi
+    </PRE>
+    The server will then recognise that all files in that location (and
+    its logical descendants) that end in &quot;<SAMP>.cgi</SAMP>&quot;
+    are script files, not documents.
+   </LI>
+   <LI>Make sure that the directory location is covered by an
+    <A
+     HREF="../mod/core.html#options"
+    >Options</A>
+    declaration that includes the <SAMP>ExecCGI</SAMP> option.
+   </LI>
+  </OL>
+  <HR>
+ </LI>
  <LI><A
       NAME="premature-script-headers"
      ><STRONG>What does it mean when my CGIs fail with &quot;Premature