commit 746a7853f71cd9a260b8722ee4e60cd99a7bcdc8
author Tom Finegan <tomfinegan@google.com> Fri Jun 02 11:29:48 2017 -0700
committer Tom Finegan <tomfinegan@google.com> Tue Jun 06 20:20:44 2017 +0000
tree b900ed1921c6d086906422c72fd44d2ea9a4a1c1
parent 185575a7713722588063e439471aa46df6f63c84

Add doxygen template to CMake docs target.

- Adds the template file to the target enabling easy
  edit via IDE editor.
- Drop a generated file comment at the beginning of
  the generated doxyfile in hopes of informing users it
  should not be modified.

BUG=aomedia:76,aomedia:559

Change-Id: Id4e2762a5dae145927e7b7f1f6689744150ba090

docs.cmake

diff --git a/docs.cmake b/docs.cmake
index d6c5c26..c93a2df 100644
--- a/docs.cmake
+++ b/docs.cmake
@@ -202,10 +202,9 @@
   set(AOM_DOXYGEN_SOURCES ${AOM_DOXYGEN_SOURCES} ${samples_dox})
 
   # Generate libaom's doxyfile.
-  file(COPY "${AOM_ROOT}/${AOM_DOXYGEN_CONFIG_TEMPLATE}"
-       DESTINATION "${AOM_CONFIG_DIR}")
-  file(RENAME
-       "${AOM_CONFIG_DIR}/${AOM_DOXYGEN_CONFIG_TEMPLATE}" "${AOM_DOXYFILE}")
+  file(WRITE "${AOM_DOXYFILE}" "##\n## GENERATED FILE. DO NOT EDIT\n##\n")
+  file(READ "${AOM_ROOT}/${AOM_DOXYGEN_CONFIG_TEMPLATE}" doxygen_template_data)
+  file(APPEND "${AOM_DOXYFILE}" ${doxygen_template_data})
   file(APPEND "${AOM_DOXYFILE}"
        "EXAMPLE_PATH += ${AOM_ROOT} ${AOM_ROOT}/examples\n")
   file(APPEND
@@ -221,8 +220,10 @@
                     COMMAND "${DOXYGEN_EXECUTABLE}" "${AOM_DOXYFILE}"
                     DEPENDS "${AOM_DOXYFILE}" ${AOM_DOXYGEN_SOURCES}
                              ${AOM_DOXYGEN_EXAMPLE_SOURCES}
+                             "${AOM_DOXYGEN_CONFIG_TEMPLATE}"
                     SOURCES "${AOM_DOXYFILE}" ${AOM_DOXYGEN_SOURCES}
-                             ${AOM_DOXYGEN_EXAMPLE_SOURCES})
+                             ${AOM_DOXYGEN_EXAMPLE_SOURCES}
+                             "${AOM_DOXYGEN_CONFIG_TEMPLATE}")
 endfunction ()
 
 endif ()  # AOM_DOCS_CMAKE_