gcj.texi (Limitations): Add note about org.xml.sax and org.w3c.dom.

2002-12-22  Anthony Green  <green@redhat.com>

	* gcj.texi (Limitations): Add note about org.xml.sax and
	org.w3c.dom.

From-SVN: r60411

diff --git a/gcc/java/ChangeLog b/gcc/java/ChangeLog
index 7567830e88d25d6ffce2477507509ede99c4d547..8b4a2178b101737bce9b1882431982861f5ef431 100644 (file)
--- a/gcc/java/ChangeLog
+++ b/gcc/java/ChangeLog
@@ -1,3 +1,8 @@
+2002-12-22  Anthony Green  <green@redhat.com>
+
+       * gcj.texi (Limitations): Add note about org.xml.sax and
+       org.w3c.dom.
+
 2002-12-20  Tom Tromey  <tromey@redhat.com>
 
        * jcf-write.c (generate_bytecode_insns) [SWITCH_EXPR]: Handle case

diff --git a/gcc/java/gcj.texi b/gcc/java/gcj.texi
index 64080cd7b7733785813dd3771348aaf5e58cc3d9..a6dc6a2289a73e68f8e09c847731e67d2c3b7f53 100644 (file)
--- a/gcc/java/gcj.texi
+++ b/gcc/java/gcj.texi
@@ -515,6 +515,17 @@ Sometimes the @code{libgcj} implementation of a method or class differs
 from the JDK implementation.  This is not always a bug.  Still, if it
 affects you, it probably makes sense to report it so that we can discuss
 the appropriate response.
+
+@item
+@command{gcj} does not currently allow for piecemeal replacement of
+components within @code{libgcj}. Unfortunately, programmers often want
+to use newer versions of certain packages, such as those provided by
+the Apache Software Foundation's Jakarta project.  This has forced us
+to place the @code{org.w3c.dom} and @code{org.xml.sax} packages into
+their own libraries, separate from @code{libgcj}.  If you intend to
+use these classes, you must link them explicitly with
+@code{-l-org-w3c-dom} and @code{-l-org-xml-sax}.  Future versions of
+@command{gcj} may not have this restriction.
 @end itemize
 
 @node Extensions