From 2cd09f2f16a67ebd9b12bd7c6c6cd12169b5c544 Mon Sep 17 00:00:00 2001
From: Nico Seessle <nico@apache.org>
Date: Wed, 14 Feb 2001 10:58:24 +0000
Subject: [PATCH] Added a note about how to use the srcdir-attribute (not
 include packages there) because this seems to become a very frequently asked
 question.

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

diff --git a/docs/manual/CoreTasks/javac.html b/docs/manual/CoreTasks/javac.html
index 96b8e6ae0..e11d5f10f 100644
--- a/docs/manual/CoreTasks/javac.html
+++ b/docs/manual/CoreTasks/javac.html
@@ -50,7 +50,7 @@ classname in the &quot;build.compiler&quot; property.
   </tr>
   <tr>
     <td valign="top">srcdir</td>
-    <td valign="top">location of the java files.</td>
+    <td valign="top">location of the java files. (See Notes at the end)</td>
     <td align="center" valign="top">Yes, unless nested <code>&lt;src&gt;</code> elements are present.</td>
   </tr>
   <tr>
@@ -241,6 +241,11 @@ the property <code>src2</code>. This can also be represented using nested
 for every use of an external compiler, this may be a problem of the JDK you are using.
 This problem may occur with all JDKs &lt; 1.2.</p>
 
+<p><b>Note:</b> If you wish to compile only source-files located in some packages below a
+common root you should not include these packages in the srcdir-attribute. Use include/exclude-attributes
+or elements to filter for these packages. If you include part of your package-structure inside the srcdir-attribute 
+(or nested src-elements) Ant will start to recompile your sources everytime you call it.</p>
+
 <hr>
 <p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All rights
 Reserved.</p>