diff --git a/interface/src/main/java/xsbti/AnalysisCallback.java b/interface/src/main/java/xsbti/AnalysisCallback.java
index 2ceedd4a6..70870965c 100644
--- a/interface/src/main/java/xsbti/AnalysisCallback.java
+++ b/interface/src/main/java/xsbti/AnalysisCallback.java
@@ -17,7 +17,9 @@ public interface AnalysisCallback
 	* discovered.*/
 	public void foundSubclass(File source, String subclassName, String superclassName, boolean isModule);
 	/** Called to indicate that the source file <code>source</code> depends on the source file
-	* <code>dependsOn</code>.*/
+	* <code>dependsOn</code>.  Note that only source files included in the current compilation will
+	* passed to this method.  Dependencies on classes generated by sources not in the current compilation will
+	* be passed as class dependencies to the classDependency method.*/
 	public void sourceDependency(File dependsOn, File source);
 	/** Called to indicate that the source file <code>source</code> depends on the jar
 	* <code>jar</code>.*/