svn commit: r720139 - /ant/core/trunk/docs/manual/CoreTasks/javadoc.html

[bodewig]

Author: bodewig
Date: Mon Nov 24 01:20:44 2008
New Revision: 720139

URL: http://svn.apache.org/viewvc?rev=720139&view=rev
Log:
recommend useexternalfile="true" as first option to deal with javadoc problems. 
 PR 41958.

Modified:
    ant/core/trunk/docs/manual/CoreTasks/javadoc.html

Modified: ant/core/trunk/docs/manual/CoreTasks/javadoc.html
URL: 
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/CoreTasks/javadoc.html?rev=720139&r1=720138&r2=720139&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/CoreTasks/javadoc.html (original)
+++ ant/core/trunk/docs/manual/CoreTasks/javadoc.html Mon Nov 24 01:20:44 2008
@@ -69,6 +69,13 @@
 to &lt;javadoc&gt; using <tt>classpath</tt>, <tt>classpathref</tt> attributes 
or nested
 &lt;classpath&gt; element.</p>
 
+<p><b>Note:</b> many problems with running javadoc stem from command
+  lines that have become too long - even though the error message
+  doesn't give the slightest hint this may be the problem.  If you
+  encounter problems with the task, try to set
+  the <code>useexternalfile</code> attribute to <code>true</code>
+  first.</p>
+
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
   <tr>