Index: include/layout.wml===================================================================RCS file: /cvsroot/classpath/classpath/doc/www.gnu.org/include/layout.wml,vretrieving revision 1.1diff -u -r1.1 layout.wml--- include/layout.wml 27 Nov 2003 14:49:58 -0000 1.1+++ include/layout.wml 2 Feb 2004 21:18:37 -0000@@ -89,7 +89,7 @@ -+ ## # Menu@@ -102,6 +102,7 @@ + Success Stories Index: faq/faq.wml===================================================================RCS file: /cvsroot/classpath/classpath/doc/www.gnu.org/faq/faq.wml,vretrieving revision 1.1diff -u -r1.1 faq.wml--- faq/faq.wml 27 Nov 2003 14:49:58 -0000 1.1+++ faq/faq.wml 2 Feb 2004 21:18:38 -0000@@ -31,6 +31,7 @@ %body {#FAQINDEX#:+
:#FAQINDEX#} @@ -41,7 +42,7 @@ {#FAQINDEX#:-

.

+ .
:#FAQINDEX#}

.

%body@@ -61,9 +62,115 @@ -GNU Classpath is licensed under the GPL plus a special exception. See .+GNU Classpath is licensed under the GPL plus a special exception:++
+

++Linking this library statically or dynamically with other modules is+making a combined work based on this library. Thus, the terms and+conditions of the GNU General Public License cover the whole+combination.++

+

++As a special exception, the copyright holders of this library give you+permission to link this library with independent modules to produce an+executable, regardless of the license terms of these independent+modules, and to copy and distribute the resulting executable under+terms of your choice, provided that you also meet, for each linked+independent module, the terms and conditions of the license of that+module. An independent module is a module which is not derived from+or based on this library. If you modify this library, you may extend+this exception to your version of the library, but you are not+obligated to do so. If you do not wish to do so, delete this+exception statement from your version.++

+
+++++Please check the FSF FAQ on the GNU GPL: . +++Some contributors of Classpath might be annoyed if their work was being+used under conditions that are not according to the terms of the license.+However, enforcing the license in court (if this was ever needed) would+be easier if the Free Software Foundation can claim to speak in the name+of all authors. For this reason, and for others that are specific to the+intellectual property system of the United States, GNU projects tend to+be a bit picky about getting signatures from all contributors. Please do+not see this as a personal offence.++

See also http://www.gnu.org/licenses/why-assign.html.+

++

For getting the assignment form, please send an e-mail with your name (as+it appears in your passport) and your current postal address to the+maintainer of GNU Classpath, Mark Wielaard .+

+++++++Beware: generating the complete API Documentation non-trivial and the generation of a full tree takes more then one and half hour (on a 1.4 Ghz Athlon),+150+ MB of memory, at least 25MB of tmp storage, and at least+twice so much in your obj build dir.++
    +
  1. install gcj 3.3.2 (or higher)
    ++gjdoc CVS :pserver:address@hidden:/cvsroot/cp-tools module gjdoc++
  2. install libxmlj
    ++libxmlj CVS :pserver:address@hidden:/cvsroot/classpathx module libxmlj
    +make && make install+    ++
  3. For gjdoc add at the start of gnu/classpath/tools/gjdoc/Main.java (main):
    +++ System.setProperty("javax.xml.transform.TransformerFactory",+ "gnu.xml.libxmlj.transform.TransformerFactoryImpl");+++
  4. There is a ant build.xml file, but you can also compile it all by hand together with the external/jaxp/source files from Classpath which can be copied in the src direcrory as follows:
    +++ find * -name \*.java | xargs gcj -O2 -g -o gjdoc \
    + --main=gnu.classpath.tools.gjdoc.Main+    ++
  5. Create a simple gjdoc script and put it in your PATH:
    +++ #!/bin/sh
    + CLASSPATH=/home/mark/src/libxmlj:/home/mark/src/gjdoc/src/resources \
    + LD_LIBRARY_PATH=/usr/local/libxmlj/lib \
    + /home/mark/src/gjdoc/src/gjdoc $*+    ++
  6. Configure classpah with --enable-gjdoc.+
  7. Type make and go get yourself some coffe, take a shower and do some work in the garden.+
++

There is one catch. The above setup is completely broken for some HTML+entities (see [bugs #4823] HTML entities such as auml and nbsp should be+put back in the API doc). So if you have spectacular and mysterious+crashes then make sure that your java source files don't contain such+entities.++++