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

CMakeLists.txt

@@ -52,13 +52,5 @@ if (BUILD_EXAMPLES)
   add_subdirectory(examples/log)
 endif()
 
-add_breathe_target(
-  TARGET_NAME doc-breathe
-  SOURCE_DIR ${CMAKE_SOURCE_DIR}/doc/html
-  BUILD_DIR  ${CMAKE_BINARY_DIR}
-  CACHE_DIR  ${CMAKE_BINARY_DIR}/_doctrees
-  HTML_DIR   ${CMAKE_BINARY_DIR}/html
-  DOXY_FILE  ${CMAKE_SOURCE_DIR}/doc/html/Doxyfile.in
-  CONF_FILE  ${CMAKE_SOURCE_DIR}/doc/html/conf.py.in
-  COMMENT "Documentation in HTML format with Breathe generator"
-  )
+add_subdirectory(doc)
+

cmake/etc/Variables.cmake

@@ -0,0 +1,21 @@
+set(ORGANIZATION_NAME "rtis")
+
+set(CPACK_GENERATOR "TXZ;DEB")
+set(CPACK_PACKAGE_CONTACT "Andrei Astafev <dev@246060.ru>")
+set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "MyX library")
+set(CPACK_DEBIAN_PACKAGE_SECTION "misc")
+set(CPACK_DEBIAN_PACKAGE_PRIORITY "optional")
+set(CPACK_SOURCE_IGNORE_FILES
+    .git/
+    obj.*/
+    build
+    files/var
+    debian/tmp/
+    debian/files
+    debian/.*\\\\.log$
+    debian/.*.substvars
+    debian/stamp.*
+    CMakeLists.txt.user
+    cmake/lib/.git$
+    ~$
+    \\\\..*\\\\.swp$)

cmake/etc/cpack_ignore.txt

@@ -1,14 +0,0 @@
-.pc/
-.git/
-obj.*/
-build
-files/var
-debian/tmp/
-debian/files
-debian/.*\\\\.log$
-debian/.*.substvars
-debian/stamp.*
-CMakeLists.txt.user
-cmake/lib/.git$
-~$
-\\\\..*\\\\.swp$

cmake/etc/organization.txt

@@ -1 +0,0 @@
-RTIS

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,