From 391a2c66b8b562080f7df5b5d30e4900f137a55a Mon Sep 17 00:00:00 2001
From: Astrid Malo <kess@apache.org>
Date: Mon, 26 Aug 2002 20:18:26 +0000
Subject: [PATCH] Corrected the context and added the corresponding override
 information. Corrected default values. Corrected the
 ISPAIFileChache/ISAPIFileCache directive. The correct name   is
 ISAPICacheFile. Added description for the ISAPIFakeAsync directive.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96535 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_isapi.html.en | 44 ++++++++++++++--------
 docs/manual/mod/mod_isapi.xml     | 61 ++++++++++++++++++++++++-------
 2 files changed, 76 insertions(+), 29 deletions(-)

diff --git a/docs/manual/mod/mod_isapi.html.en b/docs/manual/mod/mod_isapi.html.en
index 978ddb23eb..ebb011d1dd 100644
--- a/docs/manual/mod/mod_isapi.html.en
+++ b/docs/manual/mod/mod_isapi.html.en
@@ -18,7 +18,7 @@
     directly if you are experiencing problems running their ISAPI
     extention. <strong>Please <em>do not</em> post such problems to
     Apache's lists or bug reporting pages.</strong></p>
-<h2>Directives</h2><ul><li><a href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li><li><a href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li><li><a href="#isapifilechache">ISAPIFileChache</a></li><li><a href="#isapilognotsupported">ISAPILogNotSupported</a></li><li><a href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li></ul><h2>Usage</h2> <p>In the server configuration file, use
+<h2>Directives</h2><ul><li><a href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li><li><a href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li><li><a href="#isapicachefile">ISAPICacheFile</a></li><li><a href="#isapifakeasync">ISAPIFakeAsync</a></li><li><a href="#isapilognotsupported">ISAPILogNotSupported</a></li><li><a href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li></ul><h2>Usage</h2> <p>In the server configuration file, use
 the <a href="../mod/mod_mime.html#addhandler" class="directive"><code class="directive">AddHandler</code></a> directive to
 associate ISAPI files with the <code>isapi-isa</code> handler, and map
 it to the with their file extensions. To enable any .dll file to be
@@ -119,7 +119,7 @@ following line:</p>
 
       <dd>
         This logged message may be captured in any of the following
-        logs: 
+        logs:
 
         <ul>
           <li>in the \"%{isapi-parameter}n\" component in a
@@ -183,7 +183,8 @@ following line:</p>
 extensions to the error log</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
                   </a></td><td>ISAPIAppendLogToErrors on|off</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
                     </a></td><td><code>ISAPIAppendLogToErrors off</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
-                  </a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
+                  </a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:
+                    </a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
                   </a></td><td>Base</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:
                   </a></td><td>mod_isapi</td></tr></table></td></tr></table>
     <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
@@ -192,17 +193,18 @@ extensions to the error log</td></tr><tr><td nowrap="nowrap"><a href="directive-
                   </strong></td><td>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
 extensions to the query field</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
                   </a></td><td>ISAPIAppendLogToQuery on|off</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
-                    </a></td><td><code>ISAPIAppendLogToQuery off</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
-                  </a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
+                    </a></td><td><code>ISAPIAppendLogToQuery on</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
+                  </a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:
+                    </a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
                   </a></td><td>Base</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:
                   </a></td><td>mod_isapi</td></tr></table></td></tr></table>
     <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
     extensions to the query field (appended to the CustomLog %q
     component).</p>
-<hr><h2><a name="ISAPIFileChache">ISAPIFileChache</a> <a name="isapifilechache">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: 
+<hr><h2><a name="ISAPICacheFile">ISAPICacheFile</a> <a name="isapicachefile">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: 
                   </strong></td><td>ISAPI .dll files to be loaded at startup</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
-                  </a></td><td>ISAPIFileCache <em>file-path</em> [<em>file-path</em>] ...</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
-                  </a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
+                  </a></td><td>ISAPICacheFile <em>file-path</em> [<em>file-path</em>] ...</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
+                  </a></td><td>server config, virtual host</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
                   </a></td><td>Base</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:
                   </a></td><td>mod_isapi</td></tr></table></td></tr></table>
     <p>Specifies a space-separated list of file names to be loaded
@@ -210,24 +212,36 @@ extensions to the query field</td></tr><tr><td nowrap="nowrap"><a href="directiv
     server is shut down. This directive may be repeated for every
     ISAPI .dll file desired. The full path name of each file should
     be specified.</p>
+<hr><h2><a name="ISAPIFakeAsync">ISAPIFakeAsync</a> <a name="isapifakeasync">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: 
+                  </strong></td><td>Fake asynchronous support for isapi callbacks</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
+                  </a></td><td>ISAPIFakeAsync on|off</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
+                    </a></td><td><code>ISAPIFakeAsync off</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
+                  </a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:
+                    </a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
+                  </a></td><td>Base</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:
+                  </a></td><td>mod_isapi</td></tr></table></td></tr></table>
+    <p>While set to on, asynchronous support for isapi callbacks is
+    simulated.</p>
 <hr><h2><a name="ISAPILogNotSupported">ISAPILogNotSupported</a> <a name="isapilognotsupported">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: 
                   </strong></td><td>Log unsupported feature requests from ISAPI
 extensions</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
                   </a></td><td>ISAPILogNotSupported on|off</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
-                    </a></td><td><code>ISAPILogNotSupported on</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
-                  </a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
+                    </a></td><td><code>ISAPILogNotSupported off</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
+                  </a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:
+                    </a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
                   </a></td><td>Base</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:
                   </a></td><td>mod_isapi</td></tr></table></td></tr></table>
     <p>Logs all requests for unsupported features from ISAPI
-    extensions in the server error log. While this should be turned
-    off once all desired ISAPI modules are functioning, it defaults
-    to on to help administrators track down problems.</p>
+    extensions in the server error log. This may help administrators
+    to track down problems. Once set to on and all desired ISAPI modules
+    are functioning, it should be set back to off.</p>
 <hr><h2><a name="ISAPIReadAheadBuffer">ISAPIReadAheadBuffer</a> <a name="isapireadaheadbuffer">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: 
-                  </strong></td><td>Size of the Read Ahead Buffer sent to ISAPI 
+                  </strong></td><td>Size of the Read Ahead Buffer sent to ISAPI
 extensions</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
                   </a></td><td>ISAPIReadAheadBuffer <em>size</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
                     </a></td><td><code>ISAPIReadAheadBuffer 49152</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
-                  </a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
+                  </a></td><td>server config, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:
+                    </a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
                   </a></td><td>Base</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:
                   </a></td><td>mod_isapi</td></tr></table></td></tr></table>
     <p>Defines the maximum size of the Read Ahead Buffer sent to
diff --git a/docs/manual/mod/mod_isapi.xml b/docs/manual/mod/mod_isapi.xml
index 31da247ffc..0643460d4c 100644
--- a/docs/manual/mod/mod_isapi.xml
+++ b/docs/manual/mod/mod_isapi.xml
@@ -130,7 +130,7 @@ following line:</p>
 
       <dd>
         This logged message may be captured in any of the following
-        logs: 
+        logs:
 
         <ul>
           <li>in the \"%{isapi-parameter}n\" component in a
@@ -192,10 +192,11 @@ following line:</p>
 </section>
 
 <directivesynopsis>
-<name>ISAPIFileChache</name>
+<name>ISAPICacheFile</name>
 <description>ISAPI .dll files to be loaded at startup</description>
-<syntax>ISAPIFileCache <em>file-path</em> [<em>file-path</em>] ...</syntax>
-<contextlist><context>server config</context></contextlist>
+<syntax>ISAPICacheFile <em>file-path</em> [<em>file-path</em>] ...</syntax>
+<contextlist><context>server config</context>
+<context>virtual host</context></contextlist>
 
 <usage>
     <p>Specifies a space-separated list of file names to be loaded
@@ -208,11 +209,14 @@ following line:</p>
 
 <directivesynopsis>
 <name>ISAPIReadAheadBuffer</name>
-<description>Size of the Read Ahead Buffer sent to ISAPI 
+<description>Size of the Read Ahead Buffer sent to ISAPI
 extensions</description>
 <syntax>ISAPIReadAheadBuffer <em>size</em></syntax>
 <default>ISAPIReadAheadBuffer 49152</default>
-<contextlist><context>server config</context></contextlist>
+<contextlist><context>server config</context>
+<context>directory</context>
+<context>.htaccess</context></contextlist>
+<override>FileInfo</override>
 
 <usage>
     <p>Defines the maximum size of the Read Ahead Buffer sent to
@@ -228,14 +232,18 @@ extensions</description>
 <description>Log unsupported feature requests from ISAPI
 extensions</description>
 <syntax>ISAPILogNotSupported on|off</syntax>
-<default>ISAPILogNotSupported on</default>
-<contextlist><context>server config</context></contextlist>
+<default>ISAPILogNotSupported off</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+<context>.htaccess</context></contextlist>
+<override>FileInfo</override>
 
 <usage>
     <p>Logs all requests for unsupported features from ISAPI
-    extensions in the server error log. While this should be turned
-    off once all desired ISAPI modules are functioning, it defaults
-    to on to help administrators track down problems.</p>
+    extensions in the server error log. This may help administrators
+    to track down problems. Once set to on and all desired ISAPI modules
+    are functioning, it should be set back to off.</p>
 </usage>
 </directivesynopsis>
 
@@ -245,7 +253,11 @@ extensions</description>
 extensions to the error log</description>
 <syntax>ISAPIAppendLogToErrors on|off</syntax>
 <default>ISAPIAppendLogToErrors off</default>
-<contextlist><context>server config</context></contextlist>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+<context>.htaccess</context></contextlist>
+<override>FileInfo</override>
 
 <usage>
     <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
@@ -258,8 +270,12 @@ extensions to the error log</description>
 <description>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
 extensions to the query field</description>
 <syntax>ISAPIAppendLogToQuery on|off</syntax>
-<default>ISAPIAppendLogToQuery off</default>
-<contextlist><context>server config</context></contextlist>
+<default>ISAPIAppendLogToQuery on</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+<context>.htaccess</context></contextlist>
+<override>FileInfo</override>
 
 <usage>
     <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
@@ -268,4 +284,21 @@ extensions to the query field</description>
 </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>ISAPIFakeAsync</name>
+<description>Fake asynchronous support for isapi callbacks</description>
+<syntax>ISAPIFakeAsync on|off</syntax>
+<default>ISAPIFakeAsync off</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+<context>.htaccess</context></contextlist>
+<override>FileInfo</override>
+
+<usage>
+    <p>While set to on, asynchronous support for isapi callbacks is
+    simulated.</p>
+</usage>
+</directivesynopsis>
+
 </modulesynopsis>
\ No newline at end of file
-- 
2.40.0