svn commit: r1507092 - in /tomcat/jk/trunk/xdocs: miscellaneous/faq.xml reference/apache.xml webserver_howto/apache.xml

[rj...@apache.org]

Author: rjung
Date: Thu Jul 25 19:04:54 2013
New Revision: 1507092

URL: http://svn.apache.org/r1507092
Log:
Clean up some Apache version info.

Modified:
    tomcat/jk/trunk/xdocs/miscellaneous/faq.xml
    tomcat/jk/trunk/xdocs/reference/apache.xml
    tomcat/jk/trunk/xdocs/webserver_howto/apache.xml

Modified: tomcat/jk/trunk/xdocs/miscellaneous/faq.xml
URL: http://svn.apache.org/viewvc/tomcat/jk/trunk/xdocs/miscellaneous/faq.xml?rev=1507092&r1=1507091&r2=1507092&view=diff
==============================================================================
--- tomcat/jk/trunk/xdocs/miscellaneous/faq.xml (original)
+++ tomcat/jk/trunk/xdocs/miscellaneous/faq.xml Thu Jul 25 19:04:54 2013
@@ -237,27 +237,33 @@ Note: The above steps assume that you do
 </p>
 </subsection>
 
-<subsection name="Apache 2.0 complains about incorrect module version">
+<subsection name="Apache complains about incorrect module version">
 <p>
-Since Apache 2.0 API still change often, the Apache 2.0 teams decide to put in headers of compiled modules the 
-Apache 2.0 version used to compile the module. This check is called Magic Module Number bump.
+Since the Apache API can change between versions, any Apache module contains the
+Apache API version used to compile the module. This is called the Magic Module Number.
 </p>
 <p>
-At start time Apache 2.0 check that version in modules headers and stop if it detect that a module was compiled 
-for another Apache 2.0 version. As such you should allways use modules compiled for the same Apache 2.0 version. 
-This check may be removed if the future.
+At start time Apache checks that the version in the module header is compatible
+with the Apache server. If not it will deny to start and log an error.
+</p>
+<p>
+Note that minor versions are forward compatible. If the module was compiled using
+Apache 2.x.y the resulting binary should work with any other version 2.x.z where z
+is bigger or equals to y. If you also need compatibility for versions 2.x.z
+with z smaller than y, use the configure flag --enable-api-compatibility. Note
+that the module compiled with any 2.x will never be compatible with 2.y for
+x different from y.
 </p>
 </subsection>
 
-<subsection name="Does it work for Apache 2.2?">
+<subsection name="Does it work for the latest Apache 2.x?">
 <p>
-mod_jk works well with Apache 2.2. You need a binary module compiled for version 2.2 of the Apache web server.
-A binary compiled for version 2.0 will not work.
+mod_jk works well with Apache 2.x from 2.0 to 2.4.
 </p>
 <p>
 Important parts of the functionality of mod_jk have been reimplemented as Apache httpd modules mod_proxy_ajp
 and mod_proxy_balancer. These are part of the standard distributoin of Apache 2.2. The new modules do not contain
-all features of mod_jk, but you get them automatically with every Apache 2.2.
+all features of mod_jk, but you get them automatically with every Apache 2.2 and later.
 </p>
 </subsection>
 

Modified: tomcat/jk/trunk/xdocs/reference/apache.xml
URL: http://svn.apache.org/viewvc/tomcat/jk/trunk/xdocs/reference/apache.xml?rev=1507092&r1=1507091&r2=1507092&view=diff
==============================================================================
--- tomcat/jk/trunk/xdocs/reference/apache.xml (original)
+++ tomcat/jk/trunk/xdocs/reference/apache.xml Thu Jul 25 19:04:54 2013
@@ -1084,7 +1084,7 @@ ways of defining the forwards, in genera
 If you neither specify any workers via JkMount and the related directives,
 not via the environment variable described below,
 the first worker in the list of all worker will be chosen. You can use SetHandler
-for example in Location blocks or with Apache 2.2 also in RewriteRule.
+for example in Location blocks or with Apache 2.2 and later also in RewriteRule.
 </p>
 <p>
 In order to control the worker using <b>SetEnvIf</b> or <b>RewriteRule</b>

Modified: tomcat/jk/trunk/xdocs/webserver_howto/apache.xml
URL: http://svn.apache.org/viewvc/tomcat/jk/trunk/xdocs/webserver_howto/apache.xml?rev=1507092&r1=1507091&r2=1507092&view=diff
==============================================================================
--- tomcat/jk/trunk/xdocs/webserver_howto/apache.xml (original)
+++ tomcat/jk/trunk/xdocs/webserver_howto/apache.xml Thu Jul 25 19:04:54 2013
@@ -31,8 +31,7 @@
 <section name="Introduction">
 <p>
 This document explains how to connect Tomcat to the popular open source web server, Apache httpd.
-There is actually three versions of Apache HTTP Server, 1.3, 2.0 and 2.2 and all can be used with mod_jk,
-the Tomcat redirector module.
+You can use mod_jk, the Tomcat redirector module, with any version of Apache starting with 1.3.
 </p>
 
 <p>
@@ -902,10 +901,11 @@ You could set <b>CFLAGS</b> and <b>LDFLA
 </screen>
 
 <p>
-If you want to build mod_jk for different version of Apache httpd, like 1.3, 2.x,
+If you want to build mod_jk for different version of Apache httpd, like 1.3 or 2.x,
 you need to go through the full build process for each of them.
-Please note, that httpd 2.0 and 2.2 or 2.3 modules are <b>not</b> compatible. The mod_jk directory
-used is "apache-2.0" in both cases, but you need to compile separately.
+Please note, that httpd 2.0, 2.2 or 2.4 modules are <b>not</b> binary compatible.
+You have to compile the module using the Apache version you plan to run it in.
+The mod_jk build directory used is "apache-2.0" for all 2.x builds.
 <ul>
 <li>
 use configure and indicate the correct Apache httpd apxs location (--with-apxs)



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org