annotate doc/CMakeLists.txt @ 249:f4dc208aa1e3

doc: improve readability
author David Demelier <markand@malikania.fr>
date Tue, 01 Dec 2020 17:18:12 +0100
parents a8512094169e
children c4da052c0def
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 #
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 # CMakeLists.txt -- CMake build system for molko
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 #
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 # Copyright (c) 2020 David Demelier <markand@malikania.fr>
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 #
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 # Permission to use, copy, modify, and/or distribute this software for any
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 # purpose with or without fee is hereby granted, provided that the above
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 # copyright notice and this permission notice appear in all copies.
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 #
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 # WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 # MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 # ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 #
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 project(doc)
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
20
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
21 find_package(Doxygen QUIET)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
22 find_program(MKDOCS_EXE mkdocs DOC "Path to mkdocs")
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
23 find_program(DOXYBOOK2_EXE doxybook2 DOC "Path to doxybook2")
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
24 find_program(SH_EXE sh DOC "Path to a POSIX shell")
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
25
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
26 if (DOXYGEN_FOUND AND MKDOCS_EXE AND DOXYBOOK2_EXE AND SH_EXE)
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
27 set(
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
28 DOXYGEN_SOURCES
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
29 libmlk-core
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
30 libmlk-ui
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
31 libmlk-rpg
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
32 ${doc_SOURCE_DIR}/doxygen/groups.c
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
33 )
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
34
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 set(
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
36 DOXYGEN_STRIP_FROM_PATH
246
a8512094169e doc: update doxygen files list
David Demelier <markand@malikania.fr>
parents: 245
diff changeset
37 ${CMAKE_SOURCE_DIR}/libmlk-core
a8512094169e doc: update doxygen files list
David Demelier <markand@malikania.fr>
parents: 245
diff changeset
38 ${CMAKE_SOURCE_DIR}/libmlk-ui
a8512094169e doc: update doxygen files list
David Demelier <markand@malikania.fr>
parents: 245
diff changeset
39 ${CMAKE_SOURCE_DIR}/libmlk-rpg
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
40 )
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
41 set(
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
42 DOC_SOURCES
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
43 ${doc_SOURCE_DIR}/docs/specs/map.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
44 ${doc_SOURCE_DIR}/docs/specs/tileset.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
45 ${doc_SOURCE_DIR}/docs/tools/bcc.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
46 ${doc_SOURCE_DIR}/docs/tools/map.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
47 ${doc_SOURCE_DIR}/docs/tools/tileset.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
48 ${doc_SOURCE_DIR}/docs/about.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
49 ${doc_SOURCE_DIR}/docs/index.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
50 ${doc_SOURCE_DIR}/docs/install.md
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
51 ${doc_SOURCE_DIR}/mkdocs.yml
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 )
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
53
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
54 # 1. Generate XML structure with Doxygen.
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
55 set(DOXYGEN_ALLOW_UNICODE_NAMES YES)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
56 set(DOXYGEN_AUTOLINK_SUPPORT NO)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
57 set(DOXYGEN_ENABLE_PREPROCESSING YES)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
58 set(DOXYGEN_EXAMPLE_PATH examples)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
59 set(DOXYGEN_EXCLUDE_PATTERNS *_p.h)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
60 set(DOXYGEN_FILE_PATTERNS *.h)
249
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
61 set(DOXYGEN_GENERATE_HTML YES)
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
62 set(DOXYGEN_GENERATE_LATEX NO)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
63 set(DOXYGEN_GENERATE_MAN NO)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
64 set(DOXYGEN_GENERATE_XML YES)
249
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
65 set(DOXYGEN_HIDE_SCOPE_NAMES YES)
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
66 set(DOXYGEN_INPUT_ENCODING UTF-8)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
67 set(DOXYGEN_MAX_INITIALIZER_LINES 0)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
68 set(DOXYGEN_OPTIMIZE_OUTPUT_FOR_C YES)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
69 set(DOXYGEN_OUTPUT_DIRECTORY doxygen)
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
70 set(DOXYGEN_PREDEFINED DOXYGEN)
249
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
71 set(DOXYGEN_QUIET YES)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
72 set(DOXYGEN_RECURSIVE YES)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
73 set(DOXYGEN_SHOW_GROUPED_MEMB_INC NO)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
74 set(DOXYGEN_SHOW_INCLUDE_FILES NO)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
75 set(DOXYGEN_SHOW_USED_FILES NO)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
76 set(DOXYGEN_TAB_SIZE 8)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
77 set(DOXYGEN_WARNINGS YES)
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
78
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
79 set(DOXYGEN_HTML_OUTPUT ${doc_BINARY_DIR}/doxygen/html)
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
80 set(DOXYGEN_XML_OUTPUT ${doc_BINARY_DIR}/doxygen/xml)
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
81
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
82 # 0. Create commands to prepare the output build directory.
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
83 list(
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
84 APPEND commands
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
85 COMMAND
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
86 ${CMAKE_COMMAND} -E make_directory ${doc_BINARY_DIR}/docs/cmake
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
87 COMMAND
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
88 ${CMAKE_COMMAND} -E copy_directory
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
89 ${doc_SOURCE_DIR}/docs
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
90 ${doc_BINARY_DIR}/docs
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
91 COMMAND
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
92 ${CMAKE_COMMAND} -E copy
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
93 ${doc_SOURCE_DIR}/mkdocs.yml
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
94 ${doc_BINARY_DIR}
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
95 )
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
96
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
97 # 1. Generate HTML/XML from doxygen.
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
98 doxygen_add_docs(
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
99 doc-doxygen
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
100 ${DOXYGEN_SOURCES}
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
101 WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
102 )
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
103
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
104 # 2. Use doxybook2 to convert doxygen XML to markdown files.
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
105 list(
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
106 APPEND commands
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
107 COMMAND ${DOXYBOOK2_EXE} -q
249
f4dc208aa1e3 doc: improve readability
David Demelier <markand@malikania.fr>
parents: 246
diff changeset
108 -t ${doc_SOURCE_DIR}/templates
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
109 -i ${doc_BINARY_DIR}/doxygen/xml
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
110 -o ${doc_BINARY_DIR}/docs
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
111 -c ${doc_SOURCE_DIR}/doxybook.json
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
112 )
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
113
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
114 # 3. Convert our CMake macros into documentation.
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
115 set(
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
116 MACROS
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
117 ${cmake_SOURCE_DIR}/MolkoBuildAssets.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
118 ${cmake_SOURCE_DIR}/MolkoBuildMaps.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
119 ${cmake_SOURCE_DIR}/MolkoBuildTilesets.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
120 ${cmake_SOURCE_DIR}/MolkoBuildTranslations.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
121 ${cmake_SOURCE_DIR}/MolkoDefineExecutable.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
122 ${cmake_SOURCE_DIR}/MolkoDefineLibrary.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
123 ${cmake_SOURCE_DIR}/MolkoDefineTest.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
124 ${cmake_SOURCE_DIR}/MolkoSetBuildDirectories.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
125 ${cmake_SOURCE_DIR}/MolkoSetCompilerFlags.cmake
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
126 )
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
127
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
128 foreach (m ${MACROS})
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
129 get_filename_component(file ${m} NAME_WE)
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
130 set(output ${doc_BINARY_DIR}/docs/cmake/${file}.md)
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
131 list(
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
132 APPEND commands
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
133 COMMAND ${SH_EXE} ${doc_SOURCE_DIR}/cmake-extract.sh ${m} > ${output}
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
134 )
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
135 endforeach ()
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
136
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
137 # Create our final targets.
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
138 add_custom_target(
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
139 doc
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
140 VERBATIM
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
141 DEPENDS doc-doxygen
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
142 SOURCES ${DOC_SOURCES} ${cmake_outputs}
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
143 WORKING_DIRECTORY ${doc_BINARY_DIR}
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
144 ${commands}
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
145 COMMAND
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
146 ${MKDOCS_EXE} build -d ${doc_BINARY_DIR}/html
224
6f6c49b95f77 doc: add libcore API
David Demelier <markand@malikania.fr>
parents: 222
diff changeset
147 )
6f6c49b95f77 doc: add libcore API
David Demelier <markand@malikania.fr>
parents: 222
diff changeset
148
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
149 add_custom_target(
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
150 doc-serve
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
151 VERBATIM
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
152 DEPENDS doc-doxygen
240
d7e5e02f70a1 doc: misc
David Demelier <markand@malikania.fr>
parents: 239
diff changeset
153 SOURCES ${DOC_SOURCES}
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
154 WORKING_DIRECTORY ${doc_BINARY_DIR}
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
155 ${commands}
239
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
156 COMMAND
d47e70da760e doc: switch to mkdocs+doxybook2, closes #2516 @2h
David Demelier <markand@malikania.fr>
parents: 233
diff changeset
157 ${MKDOCS_EXE} serve
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
158 )
240
d7e5e02f70a1 doc: misc
David Demelier <markand@malikania.fr>
parents: 239
diff changeset
159
245
97f55f6b9593 doc: add CMake macros documentation
David Demelier <markand@malikania.fr>
parents: 240
diff changeset
160 set_target_properties(doc doc-doxygen doc-serve PROPERTIES FOLDER doc)
240
d7e5e02f70a1 doc: misc
David Demelier <markand@malikania.fr>
parents: 239
diff changeset
161 source_group(TREE ${doc_SOURCE_DIR} FILES ${DOC_SOURCES})
191
633a25df450e molko-js: miscellaneous fixes
David Demelier <markand@malikania.fr>
parents:
diff changeset
162 endif ()