Hoi,

Since 2.0.37, a "better" ISAPI handler name has been available for use with mod_isapi. I requested that the handler name be changed in the trunk mod_isapi documentation about 2 weeks ago. The change was committed as r413220.

Since that commit, I have realized that the documentation for core makes reference to the "old" handler name and that core.xml and mod_isapi.xml's localizations do as well. There was recently a flurry of activity on mod_isapi itself, so now is an appropriate time to give its docs some love. :)

Since the "new" name is available from 2.0.37 onward, I have completed the name change for trunk and backported to 2.2 and 2.0. I have also added compatibility notes regarding the handler names to mod_isapi.xml for 2.0, 2.2, and trunk.

Attached, please find patches for trunk, 2.2, and 2.0. The localization changes in these patches are solely handler name changes; the surrounding text was not modified. Also, since 2.0 requires a note about version availability, its mod_isapi.xml.ko remains unchanged. In mod_isapi.xml.ko for 2.2 and trunk, I simply replaced the handler name without adding mod_isapi.xml's note that isapi-isa is still valid until 2.3. I feel that it is better to encourage people to use the "correct" way, even if it means that the compatibility note is lost for the time being. (Also, I doubt there were many users of 2.0.35 and mod_isapi, let alone Korean; and I'm sure most of those have long since upgraded to at least 2.0.39...)

One last thing: since core's documentation links the handler name to mod_isapi's documentation and doesn't mention the handler more than an example in passing, I did not include any compatibility notes there.

Warmest,

--Matt Lewandowsky

P.S. Historical sidenote: "isapi-isa" *is* a perfectly suitable name for the handler. Unfortunately, over time the Microsoft web server teams seem to have forgotten that it was once called ISAPI/ISA in IIS as well and eventually went ahead and named a web-related server "ISA". So, now Apache's using an old name which sounds even more "Microsoft-y" than just ISAPI alone. As far as I can tell, ISA was Process Software [the original progenitor of ISAPI]'s favored name at one point and was really just short for "ISAPI". Alas, since no one really cares about such historical sidenotes, "isapi-handler" is far more descriptive and memorable. Rest in peace, "isapi-isa".

--
/*
 * Matt Lewandowsky    [EMAIL PROTECTED]
 * Random Geek         http://www.iamcode.net/
 * +1 (866) 606-9696   +44 (0) 844 484 8254
 */
Index: core.xml
===================================================================
--- core.xml	(revision 416671)
+++ core.xml	(working copy)
@@ -125,7 +125,7 @@
     The core handler for normal files defaults to rejecting
     <code>PATH_INFO</code> requests. Handlers that serve scripts, such as <a
     href="mod_cgi.html">cgi-script</a> and <a
-    href="mod_isapi.html">isapi-isa</a>, generally accept
+    href="mod_isapi.html">isapi-handler</a>, generally accept
     <code>PATH_INFO</code> by default.</dd>
     </dl>
 
Index: core.xml.de
===================================================================
--- core.xml.de	(revision 416671)
+++ core.xml.de	(working copy)
@@ -79,7 +79,7 @@
     f&uuml;r gew&ouml;hnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
     standardm&auml;&szlig;ig zur&uuml;ck. Handler, die Skripte bedienen,
     wie z.B. <a href="mod_cgi.html">cgi-script</a> und
-    <a href="mod_isapi.html">isapi-isa</a>, sind im Allgemeinen darauf
+    <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
     voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
     </dl>
 
Index: core.xml.ja
===================================================================
--- core.xml.ja	(revision 416671)
+++ core.xml.ja	(working copy)
@@ -118,7 +118,7 @@
     <a href="../handler.html">$B%O%s%I%i(B</a>$B$G7h$^$j$^$9!#(B
     $BIaDL$N%U%!%$%k$N$?$a$N%3%"%O%s%I%i$N%G%U%)%k%H$O(B <code>PATH_INFO</code> $B$r5qH]$7$^$9!#(B
     <a href="mod_cgi.html">cgi-script</a> $B$d(B <a
-    href="mod_isapi.html">isapi-isa</a> $B$N$h$&$K%9%/%j%W%H$r07$&%O%s%I%i$O(B
+    href="mod_isapi.html">isapi-handler</a> $B$N$h$&$K%9%/%j%W%H$r07$&%O%s%I%i$O(B
     $B0lHLE*$K%G%U%)%k%H$G(B <code>PATH_INFO</code> $B$r<u$1IU$1$^$9!#(B</dd>
     </dl>
 
Index: mod_isapi.xml
===================================================================
--- mod_isapi.xml	(revision 416671)
+++ mod_isapi.xml	(working copy)
@@ -55,6 +55,13 @@
         AddHandler isapi-handler.dll
     </example>
 
+    <compatibility>In older versions of the Apache server,
+    <code>isapi-isa</code> was the proper handler name, rather than
+    <code>isapi-handler</code>. As of 2.3 development versions of the Apache
+    server, <code>isapi-isa</code> is no longer valid. You will need to
+    change your configuration to use <code>isapi-handler</code>
+    instead.</compatibility>
+
     <p>There is no capability within the Apache server to leave a
     requested module loaded. However, you may preload and keep a
     specific module loaded by using the following syntax in your
Index: mod_isapi.xml.ko
===================================================================
--- mod_isapi.xml.ko	(revision 416671)
+++ mod_isapi.xml.ko	(working copy)
@@ -45,11 +45,11 @@
 
     <p>¼­¹ö¼³Á¤ÆÄÀÏ¿¡¼­ <directive
     module="mod_mime">AddHandler</directive> Áö½Ã¾î¸¦ »ç¿ëÇÏ¿©
-    ISAPI ÆÄÀÏ È®ÀåÀÚ¿Í <code>isapi-isa</code> Çڵ鷯¸¦ ¿¬°áÇÑ´Ù.
+    ISAPI ÆÄÀÏ È®ÀåÀÚ¿Í <code>isapi-handler</code> Çڵ鷯¸¦ ¿¬°áÇÑ´Ù.
     .dll ÆÄÀÏÀ» ISAPI extensionÀ¸·Î ó¸®ÇÏ·Á¸é httpd.conf ÆÄÀÏ¿¡
     ´ÙÀ½°ú °°ÀÌ Ãß°¡ÇÑ´Ù.</p>
     <example>
-        AddHandler isapi-isa .dll
+        AddHandler isapi-handler .dll
     </example>
 
     <p>¾ÆÆÄÄ¡ ¼­¹ö´Â ¿äûÇÑ ¸ðµâÀ» ¸Þ¸ð¸®¿¡ °è¼Ó µÑ ¼ö ¾ø´Ù.
Index: core.xml
===================================================================
--- core.xml	(revision 416671)
+++ core.xml	(working copy)
@@ -125,7 +125,7 @@
     The core handler for normal files defaults to rejecting
     <code>PATH_INFO</code> requests. Handlers that serve scripts, such as <a
     href="mod_cgi.html">cgi-script</a> and <a
-    href="mod_isapi.html">isapi-isa</a>, generally accept
+    href="mod_isapi.html">isapi-handler</a>, generally accept
     <code>PATH_INFO</code> by default.</dd>
     </dl>
 
Index: core.xml.de
===================================================================
--- core.xml.de	(revision 416671)
+++ core.xml.de	(working copy)
@@ -79,7 +79,7 @@
     f&uuml;r gew&ouml;hnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
     standardm&auml;&szlig;ig zur&uuml;ck. Handler, die Skripte bedienen,
     wie z.B. <a href="mod_cgi.html">cgi-script</a> und
-    <a href="mod_isapi.html">isapi-isa</a>, sind im Allgemeinen darauf
+    <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
     voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
     </dl>
 
Index: core.xml.ja
===================================================================
--- core.xml.ja	(revision 416671)
+++ core.xml.ja	(working copy)
@@ -118,7 +118,7 @@
     <a href="../handler.html">$B%O%s%I%i(B</a>$B$G7h$^$j$^$9!#(B
     $BIaDL$N%U%!%$%k$N$?$a$N%3%"%O%s%I%i$N%G%U%)%k%H$O(B <code>PATH_INFO</code> $B$r5qH]$7$^$9!#(B
     <a href="mod_cgi.html">cgi-script</a> $B$d(B <a
-    href="mod_isapi.html">isapi-isa</a> $B$N$h$&$K%9%/%j%W%H$r07$&%O%s%I%i$O(B
+    href="mod_isapi.html">isapi-handler</a> $B$N$h$&$K%9%/%j%W%H$r07$&%O%s%I%i$O(B
     $B0lHLE*$K%G%U%)%k%H$G(B <code>PATH_INFO</code> $B$r<u$1IU$1$^$9!#(B</dd>
     </dl>
 
Index: mod_isapi.xml
===================================================================
--- mod_isapi.xml	(revision 416671)
+++ mod_isapi.xml	(working copy)
@@ -47,14 +47,20 @@
 
     <p>In the server configuration file, use
     the <directive module="mod_mime">AddHandler</directive> directive to
-    associate ISAPI files with the <code>isapi-isa</code> handler, and map
+    associate ISAPI files with the <code>isapi-handler</code> handler, and map
     it to them with their file extensions. To enable any .dll file to be
     processed as an ISAPI extension, edit the httpd.conf file and add the
     following line:</p>
     <example>
-        AddHandler isapi-isa .dll
+        AddHandler isapi-handler .dll
     </example>
 
+    <compatibility>In older versions of the Apache server,
+    <code>isapi-isa</code> was the proper handler name, rather than
+    <code>isapi-handler</code>. For compatibility, configurations may
+    continue using <code>isapi-isa</code> through all versions of Apache
+    prior to 2.3.0.</compatibility>
+
     <p>There is no capability within the Apache server to leave a
     requested module loaded. However, you may preload and keep a
     specific module loaded by using the following syntax in your
Index: mod_isapi.xml.ko
===================================================================
--- mod_isapi.xml.ko	(revision 416671)
+++ mod_isapi.xml.ko	(working copy)
@@ -45,11 +45,11 @@
 
     <p>¼­¹ö¼³Á¤ÆÄÀÏ¿¡¼­ <directive
     module="mod_mime">AddHandler</directive> Áö½Ã¾î¸¦ »ç¿ëÇÏ¿©
-    ISAPI ÆÄÀÏ È®ÀåÀÚ¿Í <code>isapi-isa</code> Çڵ鷯¸¦ ¿¬°áÇÑ´Ù.
+    ISAPI ÆÄÀÏ È®ÀåÀÚ¿Í <code>isapi-handler</code> Çڵ鷯¸¦ ¿¬°áÇÑ´Ù.
     .dll ÆÄÀÏÀ» ISAPI extensionÀ¸·Î ó¸®ÇÏ·Á¸é httpd.conf ÆÄÀÏ¿¡
     ´ÙÀ½°ú °°ÀÌ Ãß°¡ÇÑ´Ù.</p>
     <example>
-        AddHandler isapi-isa .dll
+        AddHandler isapi-handler .dll
     </example>
 
     <p>¾ÆÆÄÄ¡ ¼­¹ö´Â ¿äûÇÑ ¸ðµâÀ» ¸Þ¸ð¸®¿¡ °è¼Ó µÑ ¼ö ¾ø´Ù.
Index: core.xml
===================================================================
--- core.xml	(revision 416671)
+++ core.xml	(working copy)
@@ -74,7 +74,7 @@
     The core handler for normal files defaults to rejecting
     <code>PATH_INFO</code> requests. Handlers that serve scripts, such as <a
     href="mod_cgi.html">cgi-script</a> and <a
-    href="mod_isapi.html">isapi-isa</a>, generally accept
+    href="mod_isapi.html">isapi-handler</a>, generally accept
     <code>PATH_INFO</code> by default.</dd>
     </dl>
 
Index: core.xml.de
===================================================================
--- core.xml.de	(revision 416671)
+++ core.xml.de	(working copy)
@@ -79,7 +79,7 @@
     f&uuml;r gew&ouml;hnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
     standardm&auml;&szlig;ig zur&uuml;ck. Handler, die Skripte bedienen,
     wie z.B. <a href="mod_cgi.html">cgi-script</a> und
-    <a href="mod_isapi.html">isapi-isa</a>, sind im Allgemeinen darauf
+    <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
     voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
     </dl>
 
Index: core.xml.es
===================================================================
--- core.xml.es	(revision 416671)
+++ core.xml.es	(working copy)
@@ -83,7 +83,7 @@
     rechaza por defecto las peticiones de <code>PATH_INFO</code>. Los
     handlers que sirven scripts, como <a
     href="mod_cgi.html">cgi-script</a> e <a
-    href="mod_isapi.html">isapi-isa</a>, generalmente aceptan
+    href="mod_isapi.html">isapi-handler</a>, generalmente aceptan
     <code>PATH_INFO</code> por defecto.</dd>
     </dl>
 
Index: core.xml.ja
===================================================================
--- core.xml.ja	(revision 416671)
+++ core.xml.ja	(working copy)
@@ -66,7 +66,7 @@
     <a href="../handler.html">$B%O%s%I%i(B</a>$B$G7h$^$j$^$9!#(B
     $BIaDL$N%U%!%$%k$N$?$a$N%3%"%O%s%I%i$N%G%U%)%k%H$O(B <code>PATH_INFO</code> $B$r5qH]$7$^$9!#(B
     <a href="mod_cgi.html">cgi-script</a> $B$d(B <a
-    href="mod_isapi.html">isapi-isa</a> $B$N$h$&$K%9%/%j%W%H$r07$&%O%s%I%i$O(B
+    href="mod_isapi.html">isapi-handler</a> $B$N$h$&$K%9%/%j%W%H$r07$&%O%s%I%i$O(B
     $B0lHLE*$K%G%U%)%k%H$G(B <code>PATH_INFO</code> $B$r<u$1IU$1$^$9!#(B</dd>
     </dl>
 
Index: mod_isapi.xml
===================================================================
--- mod_isapi.xml	(revision 416671)
+++ mod_isapi.xml	(working copy)
@@ -47,14 +47,19 @@
 
     <p>In the server configuration file, use
     the <directive module="mod_mime">AddHandler</directive> directive to
-    associate ISAPI files with the <code>isapi-isa</code> handler, and map
+    associate ISAPI files with the <code>isapi-handler</code> handler, and map
     it to them with their file extensions. To enable any .dll file to be
     processed as an ISAPI extension, edit the httpd.conf file and add the
     following line:</p>
     <example>
-        AddHandler isapi-isa .dll
+        AddHandler isapi-handler .dll
     </example>
 
+    <note>In versions prior to 2.0.37, use <code>isapi-isa</code> instead of
+    <code>isapi-handler</code>. The new handler name is not available prior
+    to version 2.0.37. For compatibility, configurations may continue using
+    <code>isapi-isa</code> through all versions of Apache 2.0.x.</note>
+
     <p>There is no capability within the Apache server to leave a
     requested module loaded. However, you may preload and keep a
     specific module loaded by using the following syntax in your

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to