diff --git a/build.gradle b/build.gradle
index 2b0e335bd..ba559f2da 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,3 +1,8 @@
+////////////////////////////////////////////////////////////////////////
+//
+//  find platform-specific SWT implementations
+//
+
 def osgi_platform
 
 switch (System.getProperty('os.name')) {
@@ -47,7 +52,9 @@ subprojects { subproject ->
 
 
 ////////////////////////////////////////////////////////////////////////
-
+//
+//  optional lint checking of Gradle scripts
+//
 
 buildscript {
 	repositories.jcenter()