Author: markt Date: Fri Jan 28 21:13:19 2011 New Revision: 1064887 URL: http://svn.apache.org/viewvc?rev=1064887&view=rev Log: Add some internal API notes to the migration page
Modified: tomcat/site/trunk/docs/migration.html tomcat/site/trunk/xdocs/migration.xml Modified: tomcat/site/trunk/docs/migration.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration.html?rev=1064887&r1=1064886&r2=1064887&view=diff ============================================================================== --- tomcat/site/trunk/docs/migration.html (original) +++ tomcat/site/trunk/docs/migration.html Fri Jan 28 21:13:19 2011 @@ -262,6 +262,9 @@ <li> <a href="#System_properties">System properties</a> </li> +<li> +<a href="#Internal_APIs">Internal APIs</a> +</li> </ol> </li> </ul> @@ -1091,6 +1094,46 @@ compatibility problems.</p> </tr> </table> + <table border="0" cellspacing="0" cellpadding="2" width="100%"> +<tr> +<td bgcolor="#828DA6"> +<font color="#ffffff" face="arial,helvetica,sanserif"> +<a name="Internal APIs"> +<!--()--> +</a> +<a name="Internal_APIs"> +<strong>Internal APIs</strong> +</a> +</font> +</td> +</tr> +<tr> +<td> +<blockquote> + + <p>Whilst the Tomcat 7 internal API is broadly compatible with Tomcat 6 + there have been many changes at the detai level and they are not binary + compatible. Developers of custom components that interact with Tomcat's + internals should review the JavaDoc for the relevant API. Of particular note + are:</p> + <ul> + <li>Use of generics.</li> + <li>A standard implementation of the Lifecycle interface that all + components extend.</li> + <li>The use of Context name rather than Context path as the unique + identifier for a Context within a Host.</li> + </ul> + + </blockquote> +</td> +</tr> +<tr> +<td> +<br/> +</td> +</tr> +</table> + </blockquote> </p> </td> Modified: tomcat/site/trunk/xdocs/migration.xml URL: http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/migration.xml?rev=1064887&r1=1064886&r2=1064887&view=diff ============================================================================== --- tomcat/site/trunk/xdocs/migration.xml (original) +++ tomcat/site/trunk/xdocs/migration.xml Fri Jan 28 21:13:19 2011 @@ -341,6 +341,23 @@ compatibility problems.</p> </subsection> + <subsection name="Internal APIs"> + + <p>Whilst the Tomcat 7 internal API is broadly compatible with Tomcat 6 + there have been many changes at the detai level and they are not binary + compatible. Developers of custom components that interact with Tomcat's + internals should review the JavaDoc for the relevant API. Of particular note + are:</p> + <ul> + <li>Use of generics.</li> + <li>A standard implementation of the Lifecycle interface that all + components extend.</li> + <li>The use of Context name rather than Context path as the unique + identifier for a Context within a Host.</li> + </ul> + + </subsection> + </section> </body> --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org