From 435a6330e2e7fbe7dbbe6dcbaca6edce232955cf Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Mon, 24 Nov 2008 09:20:44 +0000
Subject: [PATCH] recommend useexternalfile="true" as first option to deal with
 javadoc problems.  PR 41958.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@720139 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/CoreTasks/javadoc.html | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/manual/CoreTasks/javadoc.html b/docs/manual/CoreTasks/javadoc.html
index 5414ab5a8..4f1129a21 100644
--- a/docs/manual/CoreTasks/javadoc.html
+++ b/docs/manual/CoreTasks/javadoc.html
@@ -69,6 +69,13 @@ The workaround is providing the jars with these implementations (like JAXBs <tt>
 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>