diff --git a/src/main/org/apache/tools/ant/Executor.java b/src/main/org/apache/tools/ant/Executor.java
index 6d92e7e4d..426198bcf 100755
--- a/src/main/org/apache/tools/ant/Executor.java
+++ b/src/main/org/apache/tools/ant/Executor.java
@@ -35,6 +35,12 @@ public interface Executor {
 
     /**
      * Get the appropriate subproject Executor instance.
+     *
+     * This allows the top executor to control what type of executor is used to execute
+     * subprojects via <ant>/<antcall>/<subant> and task that extend these.
+     * All bundled Executors return a SingleCheckExecutor (running a merged set of
+     * depended targets for all targets called) to run sub-builds.
+     *
      * @return an Executor instance.
      */
     Executor getSubProjectExecutor();