1This is an example superbuild project to demonstrate the use of the
2CMAKE_INSTALL_MODE environment variable on.
3
4The project hierarchy is like (B = Builds / D = Link Dependency):
5
6+---------------------------------------------------------------------+
7|                           Superbuild (Top)                          |
8+---------------------------------------------------------------------+
9        |                 |                 |                 |
10        |                 |                 |                 |
11       (B)               (B)               (B)               (B)
12        |                 |                 |                 |
13        v                 v                 v                 v
14+---------------+ +---------------+ +---------------+ +---------------+
15| A: Static Lib | | B: Shared Lib | | C: Nested     | | D: Executable |
16|    Project    | |    Project    | |    Superbuild | |    Project    |
17+---------------+ +---------------+ +---------------+ +---------------+
18        ^               ^               |       |        |   |   |
19        |               |              (B)     (B)       |   |   |
20        |               |               |       |        |   |   |
21        |               |               v       |        |   |   |
22        |               |  +----------------+   |        |   |   |
23        |               |  | C1: Static Lib |   |        |   |   |
24        |               |  |     Project    |   |       (D) (D) (D)
25        |               |  +----------------+   |        |   |   |
26        |               |       ^               |        |   |   |
27        |               |       |               v        |   |   |
28        |               |      (D) +----------------+    |   |   |
29        |               |       |  | C2: Static Lib |<---+   |   |
30        |               |       +--|     Project    |        |   |
31        |               |          +----------------+        |   |
32        |               |                                    |   |
33        |               +------------------------------------+   |
34        |                                                        |
35        +--------------------------------------------------------+
36
37The superbuild system is built on top of ExternalProject_Add().
38
39NOTE that the subprojects will configure, build and install
40during the build phase ('make') of the top-level project.
41There is no install target in the top-level project!
42The CMAKE_INSTALL_PREFIX is therefore populated during the build
43phase already.
44