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&apos;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

Reply via email to