[Cronet] Generate Javadoc

components/cronet/android/java/build.xml

Index: components/cronet/android/java/build.xml
diff --git a/components/cronet/android/java/build.xml b/components/cronet/android/java/build.xml
new file mode 100644
index 0000000000000000000000000000000000000000..069662190c8c72953d11eed9708890dc7f47263c
--- /dev/null
+++ b/components/cronet/android/java/build.xml
@@ -0,0 +1,19 @@
+<project>
+  <target name="doc" description="generate documentation">
+      <javadoc destdir="${doc.dir}"
+               windowtitle="Cronet API"
+               nohelp="yes"
+               noindex="yes"

[mef, 2015/06/03 18:25:01]

Not sure what noindex does, but it would make sense to have a TOC or something.

[xunjieli, 2015/06/03 20:19:34]

Done. Removed. 

+               notree="yes"
+               nodeprecated="yes"
+               >
+        <fileset dir="${source.dir}" defaultexcludes="yes">
+          <include name="**/*.java"/>

[mef, 2015/06/03 18:25:01]

Should we generate javadoc just for interface files and not implementation? This
would reduce noise / clutter.

[xunjieli, 2015/06/03 20:19:34]

Looking at the internal code base, our current embedders are using the concrete
ones directly (eg. CronetUrlRequestContext), so I think we should still need to
keep them there.

[mef, 2015/06/03 22:00:54]

Sounds good, as long as only 'public' classes get javadoc'ed. Could you confirm
that non-public classes are not excluded?

[xunjieli, 2015/06/04 13:37:35]

Confirmed that non-public classes are not included :)

+          <!-- exclude legacy API -->
+          <exclude name="**/Chromium*.java"/>
+          <exclude name="**/ChunkedWritableByteChannel*.java"/>
+          <exclude name="**/HttpUrl*.java"/>
+        </fileset>
+      </javadoc>
+  </target>
+</project>