Deprecation of Xalan-J1 API.
diff --git a/xdocs/sources/xalan/usagepatterns.xml b/xdocs/sources/xalan/usagepatterns.xml
index d3ca63b..f7e30a5 100644
--- a/xdocs/sources/xalan/usagepatterns.xml
+++ b/xdocs/sources/xalan/usagepatterns.xml
@@ -73,7 +73,7 @@
<li><link anchor="extensions">Creating and using extensions</link></li>
<li><link anchor="multithreading">Multithreading</link></li>
<li><link anchor="debugging">Debugger interface</link></li>
-<li><link anchor="compat">Using the &xslt4j; version 1 API</link></li>
+<li><link anchor="compat">Using the &xslt4j; version 1 API</link> <em>[Deprecated]</em></li>
</ul>
<anchor name="basic"/>
<s2 title="Basic steps">
@@ -505,6 +505,9 @@
<p>For a sample application that uses this technique, see <link idref="samples" anchor="trace">Trace</link>.</p>
</s2><anchor name="compat"/>
<s2 title="Using the &xslt4j; version 1 API">
+<note><em>The compatibility jar (xalanj1compat.jar), which provides support for Xalan-Java 1 API, has been deprecated. All
+support for this API will be removed in the next releaase. If you have not already done so, we stongly urge you to shift immediately to
+the Xalan-Java 2/JAXP 1.1 API.</em></note>
<p>The bin directory includes a compatibility jar, xalanj1compat.jar, that lets you rebuild your Xalan-Java 1.x applications to run with Xalan-Java 2. As a point of reference, this JAR includes the API required to recompile the Xalan-Java 1.x core sample applications (excluding the sample extensions) and run them with Xalan-Java 2. To use this compatibility layer with an existing Xalan-Java 1.x application, do the following:</p>
<ol>
<li>Place xalanj1compat.jar on the system classpath in front of the Xalan-Java 2 xalan.jar (both are in the bin directory).<br/><br/></li>
