From eb09d0b68013f2717fdc0c4b1d3fd66cdfe1fb04 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@iernst.net>
Date: Thu, 19 Nov 2015 11:06:47 -0800
Subject: [PATCH] Add a comment explaining the -quiet parameter for adding
 javadoc options

---
 build.gradle | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/build.gradle b/build.gradle
index 4b7173c4308..15d24943117 100644
--- a/build.gradle
+++ b/build.gradle
@@ -98,6 +98,10 @@ subprojects {
     }
     // ignore missing javadocs
     tasks.withType(Javadoc) { Javadoc javadoc ->
+      // the -quiet here is because of a bug in gradle, in that adding a string option
+      // by itself is not added to the options. By adding quiet, both this option and
+      // the "value" -quiet is added, separated by a space. This is ok since the javadoc
+      // command already adds -quiet, so we are just duplicating it
       javadoc.options.addStringOption('Xdoclint:all,-missing', '-quiet')
     }
   }