buildscripts: comments

SkyExamples/build.gradle

@@ -1,9 +1,11 @@
+// Gradle script to build the SkyControl/SkyExamples sub-project
+
 // Note: "common.gradle" in the root project contains additional initialization
 //   for this project. This initialization is applied in the "build.gradle"
 //   of the root project.
 
 plugins {
-    id 'application'
+    id 'application' // to build JVM applications
 }
 
 dependencies {

SkyLibrary/build.gradle

@@ -1,11 +1,13 @@
+// Gradle script to build the SkyControl/SkyLibrary sub-project
+
 // Note: "common.gradle" in the root project contains additional initialization
 //   for this project. This initialization is applied in the "build.gradle"
 //   of the root project.
 
 plugins {
-    id 'java-library'
-    id 'maven-publish'
-    id 'signing'
+    id 'java-library'  // to build JVM libraries
+    id 'maven-publish' // to publish artifacts to Maven repositories
+    id 'signing'       // to sign artifacts for publication
 }
 
 ext {

build.gradle

@@ -1,4 +1,4 @@
-// Gradle build script for the SkyControl project
+// Gradle script to build the SkyControl project
 
 plugins {
     id 'base' // to add a "clean" task to the root project

common.gradle

@@ -1,6 +1,6 @@
 // Gradle settings and tasks common to all SkyControl subprojects
 
-apply plugin: 'checkstyle'
+apply plugin: 'checkstyle' // to analyze Java sourcecode for style violations
 apply plugin: 'java'
 
 java {