Comments.

src/main/kotlin/com/beust/kobalt/internal/JvmCompiler.kt

@@ -13,6 +13,11 @@ import java.io.File
  * Also validates the classpath and run all the contributors.
  */
 class JvmCompiler @Inject constructor(val dependencyManager: DependencyManager) {
+
+    /**
+     * Create a final, enriched CompilerActionInfo from the contributors and the transitive dependencies and
+     * then pass it to the ICompilerAction.
+     */
     fun doCompile(project: Project?, context: KobaltContext?, action: ICompilerAction, info: CompilerActionInfo)
             : TaskResult {
         File(info.outputDir).mkdirs()

src/main/kotlin/com/beust/kobalt/plugin/java/JavaCompiler.kt

@@ -47,8 +47,7 @@ class JavaCompiler @Inject constructor(val jvmCompiler: JvmCompiler) {
     }
 
     /**
-     * Create an ICompilerAction and a CompilerActionInfo suitable to be passed to doCompiler() to perform the
-     * actual compilation.
+     * Create an ICompilerAction based on the parameters and send it to JvmCompiler.doCompile().
      */
     fun compile(project: Project?, context: KobaltContext?, dependencies: List<IClasspathDependency>,
             sourceFiles: List<String>, outputDir: String, args: List<String>) : TaskResult {

src/main/kotlin/com/beust/kobalt/plugin/kotlin/KotlinCompiler.kt

@@ -52,8 +52,7 @@ class KotlinCompiler @Inject constructor(val localRepo : LocalRepo,
     }
 
     /**
-     * Create an ICompilerAction and a CompilerActionInfo suitable to be passed to doCompiler() to perform the
-     * actual compilation.
+     * Create an ICompilerAction based on the parameters and send it to JvmCompiler.doCompile().
      */
     fun compile(project: Project?, context: KobaltContext?, compileDependencies: List<IClasspathDependency>,
             otherClasspath: List<String>, source: List<String>, outputDir: String, args: List<String>) : TaskResult {