Merge pull request #1783 from ctiller/whisper-sweet-nothings-to-yourself

Add doxygen setups for internal documentation

templates/tools/doxygen/Doxyfile.c++.internal.template

@@ -0,0 +1,2 @@
+<%namespace file="Doxyfile.include" import="gen_doxyfile"/>\
+${gen_doxyfile(['grpc++'], 'C++', libs, True)}

templates/tools/doxygen/Doxyfile.c++.template

@@ -1,2 +1,2 @@
 <%namespace file="Doxyfile.include" import="gen_doxyfile"/>\
-${gen_doxyfile(['grpc++'], 'C++', libs)}
+${gen_doxyfile(['grpc++'], 'C++', libs, False)}

templates/tools/doxygen/Doxyfile.core.internal.template

@@ -0,0 +1,2 @@
+<%namespace file="Doxyfile.include" import="gen_doxyfile"/>\
+${gen_doxyfile(['grpc', 'gpr'], 'Core', libs, True)}

templates/tools/doxygen/Doxyfile.core.template

@@ -1,2 +1,2 @@
 <%namespace file="Doxyfile.include" import="gen_doxyfile"/>\
-${gen_doxyfile(['grpc', 'gpr'], 'Core', libs)}
+${gen_doxyfile(['grpc', 'gpr'], 'Core', libs, False)}

templates/tools/doxygen/Doxyfile.include

@@ -1,4 +1,4 @@
-<%def name="gen_doxyfile(libnames, packagename, collection)">
+<%def name="gen_doxyfile(libnames, packagename, collection, internal)">
 <%
   import itertools
   targets = []
@@ -770,7 +770,13 @@ WARN_LOGFILE           =
 # spaces.
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = ${' '.join(itertools.chain.from_iterable(target.public_headers for target in targets))}
+INPUT                  = ${' '.join(
+                               itertools.chain.from_iterable(
+			           target.public_headers +
+				   ([]
+				    if not internal
+				    else target.headers + target.src)
+			       for target in targets))}
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses

tools/doxygen/run_doxygen.sh

@@ -34,7 +34,7 @@ set -ex
 # change to grpc repo root
 cd $(dirname $0)/../..
 
-for i in core c++
+for i in core c++ core.internal c++.internal
 do
 	mkdir -p doc/ref/$i
 	doxygen tools/doxygen/Doxyfile.$i