Mercurial > molko
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 |
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 | 147 ) |
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 | 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 | 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 | 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 () |