gobhardw/docs logging (#10)

* reducing docs logging

* Addressing review comments

* exclude dirs

* maximize NUM_PROC_THREADS

* parallel build

source/docs/CMakeLists.txt

@@ -59,6 +59,13 @@ function(DOCS_EXECUTE_PROCESS)
     endif()
 endfunction()
 
+include(ProcessorCount)
+processorcount(ROCP_NUM_PROCS)
+if(NOT ROCP_NUM_PROCS EQUAL 0)
+    set(DOCS_BUILD_JOBS -j${ROCP_NUM_PROCS})
+    message(STATUS "Using ${ROCP_NUM_PROCS} jobs for docs build")
+endif()
+
 file(
     WRITE "${CMAKE_CURRENT_BINARY_DIR}/build-docs.sh"
     "#!${SHELL_CMD}
@@ -112,7 +119,7 @@ doxygen rocprofiler-sdk.dox
 
 doxysphinx build \${WORK_DIR} \${WORK_DIR}/_build/html \${WORK_DIR}/_doxygen/html
 
-make html SPHINXOPTS=\"-W --keep-going -n\"
+make html SPHINXOPTS=\"-W --keep-going ${DOCS_BUILD_JOBS} -n\"
 
 rm -rf ${PROJECT_SOURCE_DIR}/build-docs
 ")

source/docs/rocprofiler-sdk.dox.in

@@ -108,7 +108,7 @@ CITE_BIB_FILES         =
 #---------------------------------------------------------------------------
 # Configuration options related to warning and progress messages
 #---------------------------------------------------------------------------
-QUIET                  = NO
+QUIET                  = YES
 WARNINGS               = YES
 WARN_IF_UNDOCUMENTED   = YES
 WARN_IF_DOC_ERROR      = YES
@@ -145,7 +145,11 @@ EXCLUDE_SYMLINKS       = YES
 EXCLUDE_PATTERNS       = */.git/* \
                          @SOURCE_DIR@/**/tests/* \
                          @SOURCE_DIR@/**/scripts/* \
-                         @SOURCE_DIR@/**/docs/*
+                         @SOURCE_DIR@/**/docs/* \
+                         @SOURCE_DIR@/**/cmake/* \
+                         @SOURCE_DIR@/**/external/* \
+                         @SOURCE_DIR@/**/RPM/* \
+                         @SOURCE_DIR@/**/ISSUE_TEMPLATE/*
 EXCLUDE_SYMBOLS        = "std::*" \
                          "ROCPROFILER_ATTRIBUTE" \
                          "ROCPROFILER_API" \
@@ -395,7 +399,7 @@ DIAFILE_DIRS           =
 PLANTUML_JAR_PATH      =
 PLANTUML_CFG_FILE      =
 PLANTUML_INCLUDE_PATH  =
-DOT_GRAPH_MAX_NODES    = 50
+DOT_GRAPH_MAX_NODES    = 100
 MAX_DOT_GRAPH_DEPTH    = 0
 DOT_MULTI_TARGETS      = YES
 GENERATE_LEGEND        = YES