Автогенерация документации

doc/CMakeLists.txt

@@ -0,0 +1,20 @@
+add_breathe_target(
+  TARGET_NAME doc-breathe
+  SOURCE_DIR ${CMAKE_SOURCE_DIR}/doc/breathe
+  DOXY_FILE  ${CMAKE_SOURCE_DIR}/doc/Doxyfile.in
+  CONF_FILE  ${CMAKE_SOURCE_DIR}/doc/breathe/conf.py.in
+  OUTPUT_DIR ${CMAKE_BINARY_DIR}/doc/breathe
+  COMMENT "Documentation in HTML format with Breathe generator"
+  )
+
+add_doxygen_target(
+  TARGET_NAME doc-doxygen
+  SOURCE_DIR  ${CMAKE_SOURCE_DIR}/src
+  DOXY_FILE   ${CMAKE_SOURCE_DIR}/doc/Doxyfile.in
+  OUTPUT_DIR  ${CMAKE_BINARY_DIR}/doc
+  HTML        YES
+  LATEX       YES
+  COMMENT "Documentation in HTML and LaTeX format with Doxygen"
+  )
+
+

doc/Doxyfile.in

@@ -8,7 +8,7 @@ PROJECT_NAME           = @PROJECT_NAME@
 PROJECT_NUMBER         =
 PROJECT_BRIEF          =
 PROJECT_LOGO           =
-OUTPUT_DIRECTORY       =
+OUTPUT_DIRECTORY       = @OUTPUT_DIRECTORY@
 CREATE_SUBDIRS         = NO
 ALLOW_UNICODE_NAMES    = NO
 OUTPUT_LANGUAGE        = Russian
@@ -28,8 +28,8 @@ ABBREVIATE_BRIEF       = "The $name class" \
 ALWAYS_DETAILED_SEC    = NO
 INLINE_INHERITED_MEMB  = NO
 FULL_PATH_NAMES        = YES
-STRIP_FROM_PATH        =
-STRIP_FROM_INC_PATH    =
+STRIP_FROM_PATH        = @CMAKE_SOURCE_DIR@/src
+STRIP_FROM_INC_PATH    = @CMAKE_SOURCE_DIR@/src
 SHORT_NAMES            = NO
 JAVADOC_AUTOBRIEF      = NO
 QT_AUTOBRIEF           = NO
@@ -193,7 +193,7 @@ IGNORE_PREFIX          =
 #---------------------------------------------------------------------------
 # Configuration options related to the HTML output
 #---------------------------------------------------------------------------
-GENERATE_HTML          = NO
+GENERATE_HTML          = @GENERATE_HTML@
 HTML_OUTPUT            = html
 HTML_FILE_EXTENSION    = .html
 HTML_HEADER            =
@@ -251,7 +251,7 @@ EXTRA_SEARCH_MAPPINGS  =
 #---------------------------------------------------------------------------
 # Configuration options related to the LaTeX output
 #---------------------------------------------------------------------------
-GENERATE_LATEX         = NO
+GENERATE_LATEX         = @GENERATE_LATEX@
 LATEX_OUTPUT           = latex
 LATEX_CMD_NAME         = latex
 MAKEINDEX_CMD_NAME     = makeindex
@@ -290,7 +290,7 @@ MAN_LINKS              = NO
 #---------------------------------------------------------------------------
 # Configuration options related to the XML output
 #---------------------------------------------------------------------------
-GENERATE_XML           = YES
+GENERATE_XML           = @GENERATE_XML@
 XML_OUTPUT             = xml
 XML_PROGRAMLISTING     = YES
 #---------------------------------------------------------------------------
@@ -344,9 +344,9 @@ DOT_FONTNAME           = Helvetica
 DOT_FONTSIZE           = 10
 DOT_FONTPATH           =
 CLASS_GRAPH            = YES
-COLLABORATION_GRAPH    = YES
+COLLABORATION_GRAPH    = NO
 GROUP_GRAPHS           = YES
-UML_LOOK               = NO
+UML_LOOK               = YES
 UML_LIMIT_NUM_FIELDS   = 10
 TEMPLATE_RELATIONS     = NO
 INCLUDE_GRAPH          = YES

doc/breathe/conf.py.in

@@ -158,7 +158,7 @@ texinfo_documents = [
      'One line description of project.', 'Miscellaneous'),
 ]
 
-breathe_projects = {'@PROJECT_NAME@': '@BREATHE_DOC_BUILD_DIR@/xml'}
+breathe_projects = {'@PROJECT_NAME@': '@BREATHE_DOCS_BUILD_DIR@/xml'}
 
 
 def run_doxygen(folder):
@@ -174,7 +174,7 @@ def run_doxygen(folder):
 
 
 def setup(app):
-    run_doxygen('@BREATHE_DOC_BUILD_DIR@')
+    run_doxygen('@BREATHE_DOCS_BUILD_DIR@')
     app.add_config_value('recommonmark_config', {
         'enable_auto_toc_tree': True,
         'enable_eval_rst': True,