From e245dfcc3d03f27999c20d81a80dd0ee0926694f Mon Sep 17 00:00:00 2001
From: stephengold <sgold@sonic.net>
Date: Fri, 10 May 2024 11:44:07 -0700
Subject: [PATCH] buildscripts:  comments

---
 apps/build.gradle | 4 ++--
 common.gradle     | 4 ++--
 lib/build.gradle  | 8 ++++----
 settings.gradle   | 4 +---
 4 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/apps/build.gradle b/apps/build.gradle
index d439def2..58ba35fc 100644
--- a/apps/build.gradle
+++ b/apps/build.gradle
@@ -1,11 +1,11 @@
-// Gradle script to build the MonkeyWrench/apps sub-project
+// Gradle script to build the "apps" subproject of MonkeyWrench
 
 // 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' // to build Java applications
+    id 'application' // to build JVM applications
 }
 
 // Register tasks to run specific applications:
diff --git a/common.gradle b/common.gradle
index 03f82a1d..82160371 100644
--- a/common.gradle
+++ b/common.gradle
@@ -1,7 +1,7 @@
 // Gradle settings and tasks common to all MonkeyWrench subprojects
 
-apply plugin: 'checkstyle'
-apply plugin: 'java'
+apply plugin: 'checkstyle' // to analyze Java sourcecode for style violations
+apply plugin: 'java'       // to compile and test Java projects
 
 java {
     sourceCompatibility = JavaVersion.VERSION_1_8
diff --git a/lib/build.gradle b/lib/build.gradle
index 840f7f04..e692e799 100644
--- a/lib/build.gradle
+++ b/lib/build.gradle
@@ -1,13 +1,13 @@
-// Gradle script to build the MonkeyWrench/lib sub-project
+// Gradle script to build the "lib" subproject of MonkeyWrench
 
 // 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 {
diff --git a/settings.gradle b/settings.gradle
index 94af3b9b..cf3919aa 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -1,6 +1,4 @@
-/*
- * settings.gradle: global settings shared by all MonkeyWrench subprojects
- */
+// global settings shared by all MonkeyWrench subprojects
 
 dependencyResolutionManagement {
     repositories {