diff --git a/build.xml b/build.xml
index 182b6655096..90421ff0b54 100644
--- a/build.xml
+++ b/build.xml
@@ -539,12 +539,15 @@
         </jar>
     </target>
 
+    <!-- builds redistributables from sources -->
     <target name="dist"
             depends="clean,init,prepareDist,compileGenerators,invokeGenerators,preloader,compiler,compilerSources,antTools,jdkAnnotations,annotationsExt,runtime,jslib,j2kConverter"/>
 
+    <!-- builds everything, but classes are reused from project out dir, doesn't run proguard and javadoc -->
     <target name="dist_quick"
             depends="clean,init,prepareDist,preloader,compiler_quick,antTools,jdkAnnotations,annotationsExt,runtime,jslib,j2kConverter"/>
 
+    <!-- builds compiler jar from project out dir -->
     <target name="dist_quick_compiler_only"
             depends="init,prepareDist,preloader,compiler_quick"/>