You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by vs...@apache.org on 2008/07/21 14:03:10 UTC

svn commit: r678399 - /maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml

Author: vsiveton
Date: Mon Jul 21 05:03:09 2008
New Revision: 678399

URL: http://svn.apache.org/viewvc?rev=678399&view=rev
Log:
MJAVADOC-200: Exception creating report - slash/backslash problem

o added a FAQ entry and point to Sun issue.

Modified:
    maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml

Modified: maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml?rev=678399&r1=678398&r2=678399&view=diff
==============================================================================
--- maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml (original)
+++ maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml Mon Jul 21 05:03:09 2008
@@ -226,5 +226,127 @@
         </p>
       </answer>
     </faq>
+    <faq id="On Sun JDK, why javadoc:javadoc goal blows up due to an IllegalArgumentException in sun.net.www.ParseUtil.decode()">
+      <question>On Sun JDK, why <i>javadoc:javadoc</i> goal blows up due to an IllegalArgumentException in <i>sun.net.www.ParseUtil.decode()</i>?</question>
+      <answer>
+        <p>
+          You are on Windows XP with Sun JDK 5 or JDK 6 freshly installed, and when you run <i>mvn javadoc:javadoc</i>,
+          you are stick by an <i>sun.net.www.ParseUtil.decode()</i> exception like this
+          <a href="javascript:;" onclick="toggleException( '_6219854' );" style="cursor: pointer;vertical-align:text-bottom;">one</a>.
+          <div id="_6219854" style="display:none">
+            <source>
+...
+[INFO] ------------------------------------------------------------------------
+[ERROR] BUILD ERROR
+[INFO] ------------------------------------------------------------------------
+[INFO] An error has occurred in JavaDocs report generation:Exit code: 1 - java.lang.IllegalArgumentException
+  at sun.net.www.ParseUtil.decode(ParseUtil.java:189)
+  at sun.misc.URLClassPath$FileLoader.&lt;init&gt;(URLClassPath.java:953)
+  at sun.misc.URLClassPath$3.run(URLClassPath.java:326)
+  at java.security.AccessController.doPrivileged(Native Method)
+  at sun.misc.URLClassPath.getLoader(URLClassPath.java:320)
+  at sun.misc.URLClassPath.getLoader(URLClassPath.java:297)
+  at sun.misc.URLClassPath.findResource(URLClassPath.java:144)
+  at java.net.URLClassLoader$2.run(URLClassLoader.java:362)
+  at java.security.AccessController.doPrivileged(Native Method)
+  at java.net.URLClassLoader.findResource(URLClassLoader.java:359)
+  at java.lang.ClassLoader.getResource(ClassLoader.java:977)
+  at java.lang.ClassLoader.getResourceAsStream(ClassLoader.java:1159)
+  at javax.xml.parsers.SecuritySupport$4.run(SecuritySupport.java:96)
+  at java.security.AccessController.doPrivileged(Native Method)
+  at javax.xml.parsers.SecuritySupport.getResourceAsStream(SecuritySupport.java:89)
+  at javax.xml.parsers.FactoryFinder.findJarServiceProvider(FactoryFinder.java:250)
+  at javax.xml.parsers.FactoryFinder.find(FactoryFinder.java:223)
+  at javax.xml.parsers.SAXParserFactory.newInstance(SAXParserFactory.java:128)
+  at com.sun.tools.doclets.internal.toolkit.builders.LayoutParser.parseXML(LayoutParser.java:72)
+  at com.sun.tools.doclets.internal.toolkit.builders.ClassBuilder.build(ClassBuilder.java:108)
+  at com.sun.tools.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:155)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:164)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:106)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64)
+  at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42)
+  at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)
+  at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
+  at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
+  at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
+  at java.lang.reflect.Method.invoke(Method.java:597)
+  at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:215)
+  at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:91)
+  at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
+  at com.sun.tools.javadoc.Start.begin(Start.java:128)
+  at com.sun.tools.javadoc.Main.execute(Main.java:41)
+  at com.sun.tools.javadoc.Main.main(Main.java:31)
+  com.sun.tools.doclets.internal.toolkit.util.DocletAbortException
+  at com.sun.tools.doclets.internal.toolkit.builders.LayoutParser.parseXML(LayoutParser.java:79)
+  at com.sun.tools.doclets.internal.toolkit.builders.ClassBuilder.build(ClassBuilder.java:108)
+  at com.sun.tools.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:155)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:164)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:106)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64)
+  at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42)
+  at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)
+  at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
+  at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
+  at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
+  at java.lang.reflect.Method.invoke(Method.java:597)
+  at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:215)
+  at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:91)
+  at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
+  at com.sun.tools.javadoc.Start.begin(Start.java:128)
+  at com.sun.tools.javadoc.Main.execute(Main.java:41)
+  at com.sun.tools.javadoc.Main.main(Main.java:31)
+  com.sun.tools.doclets.internal.toolkit.util.DocletAbortException
+  at com.sun.tools.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:159)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:164)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:106)
+  at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64)
+  at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42)
+  at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)
+  at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
+  at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
+  at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
+  at java.lang.reflect.Method.invoke(Method.java:597)
+  at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:215)
+  at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:91)
+  at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
+  at com.sun.tools.javadoc.Start.begin(Start.java:128)
+  at com.sun.tools.javadoc.Main.execute(Main.java:41)
+  at com.sun.tools.javadoc.Main.main(Main.java:31)
+
+  Command line was:C:\Java\jdk1.6.0_03\jre\..\bin\javadoc.exe @options @packages
+  ...</source>
+            </div>
+        </p>
+        <p>
+          Your <i>CLASSPATH</i> environement variable is probably corrupted, i.e. something like:
+          <source>CLASSPATH=.;C:\Java\jdk1.6.0_03\jre\lib\ext\QTJava.zip;%JAVAHOME%</source>
+        </p>
+        <p>
+          To resolve it, just reset the <i>CLASSPATH</i> environement variable, i.e.: <source>set CLASSPATH=</source>
+          or set a new <i>CLASSPATH</i> environement variable, i.e.:
+          <source>set CLASSPATH=C:\Java\jdk1.6.0_03\jre\lib\ext\QTJava.zip</source>
+        </p>
+        <p>
+          Refer you to
+          <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6219854">http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6219854</a>
+          from Sun for more details.
+        </p>
+
+        <script language="javascript" type="text/javascript">
+          function toggleException( divId )
+          {
+            var div = document.getElementById( divId );
+            if( div.style.display == '' )
+            {
+              div.style.display = 'none';
+            }
+            else
+            {
+              div.style.display = '';
+            }
+          }
+        </script>
+      </answer>
+    </faq>
   </part>
 </faqs>
\ No newline at end of file