diff --git a/releng.control/localBuildExample/javadoc.properties b/releng.control/localBuildExample/javadoc.properties
index f7a428bdc130d8cdcaafdffc4f5f94e63d465d08..68f12266be288d109c2f8a23d4ecb60182324e94 100644
--- a/releng.control/localBuildExample/javadoc.properties
+++ b/releng.control/localBuildExample/javadoc.properties
@@ -2,6 +2,8 @@
 # will cause java doc generation to be skipped, for 
 # those java doc plugins that support it
 # (as of this writing, jst.doc.isv and wst.doc.isv
-
+# Note: some parts of the javadoc generation will still 
+# occur, but plugin's created, some files copied, etc., 
+# but just not the very expensive javadoc task itself.
 skipJavaDoc=true
 
diff --git a/releng.wtpbuilder/localBuildExample/javadoc.properties b/releng.wtpbuilder/localBuildExample/javadoc.properties
index f7a428bdc130d8cdcaafdffc4f5f94e63d465d08..68f12266be288d109c2f8a23d4ecb60182324e94 100644
--- a/releng.wtpbuilder/localBuildExample/javadoc.properties
+++ b/releng.wtpbuilder/localBuildExample/javadoc.properties
@@ -2,6 +2,8 @@
 # will cause java doc generation to be skipped, for 
 # those java doc plugins that support it
 # (as of this writing, jst.doc.isv and wst.doc.isv
-
+# Note: some parts of the javadoc generation will still 
+# occur, but plugin's created, some files copied, etc., 
+# but just not the very expensive javadoc task itself.
 skipJavaDoc=true