mirror of
1
0
Fork 0

style: update style

This commit is contained in:
Henry Schreiner 2020-08-03 18:16:52 -04:00
parent 6c75155baf
commit 9aa936555e
39 changed files with 95 additions and 120 deletions

View File

@ -34,4 +34,3 @@ pages:
paths: paths:
- public - public
expire_in: 1 week expire_in: 1 week

View File

@ -1 +1 @@
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

View File

@ -94,4 +94,3 @@ There are some other places to find good information on the web. Here are some o
Modern CMake was originally written by [Henry Schreiner](https://iscinumpy.gitlab.io). Other contributors can be found [listed on GitLab](https://gitlab.com/CLIUtils/modern-cmake/-/network/master). Modern CMake was originally written by [Henry Schreiner](https://iscinumpy.gitlab.io). Other contributors can be found [listed on GitLab](https://gitlab.com/CLIUtils/modern-cmake/-/network/master).
[^1]: CMake 3.0 also removed several long deprecated features from very old versions of CMake and make one very tiny backwards incompatible change to syntax related to square brackets, so this is not entirely fair; there might be some very, very old CMake files that would stop working with 3. I've never seen one, though. [^1]: CMake 3.0 also removed several long deprecated features from very old versions of CMake and make one very tiny backwards incompatible change to syntax related to square brackets, so this is not entirely fair; there might be some very, very old CMake files that would stop working with 3. I've never seen one, though.

View File

@ -20,9 +20,9 @@
* [IDEs](chapters/features/ides.md) * [IDEs](chapters/features/ides.md)
* [Debugging](chapters/features/debug.md) * [Debugging](chapters/features/debug.md)
* [Including Projects](chapters/projects.md) * [Including Projects](chapters/projects.md)
* [Submodule](chapters/projects/submodule.md) * [Submodule](chapters/projects/submodule.md)
* [DownloadProject](chapters/projects/download.md) * [DownloadProject](chapters/projects/download.md)
* [Fetch (CMake 3.11)](chapters/projects/fetch.md) * [Fetch (CMake 3.11)](chapters/projects/fetch.md)
* [Testing](chapters/testing.md) * [Testing](chapters/testing.md)
* [GoogleTest](chapters/testing/googletest.md) * [GoogleTest](chapters/testing/googletest.md)
* [Catch](chapters/testing/catch.md) * [Catch](chapters/testing/catch.md)

View File

@ -157,7 +157,7 @@ See if you can follow the following file. It makes a simple C++11 library and a
cmake_minimum_required(VERSION 3.8) cmake_minimum_required(VERSION 3.8)
project(Calculator LANGUAGES CXX) project(Calculator LANGUAGES CXX)
add_library(calclib STATIC src/calclib.cpp include/calc/lib.hpp) add_library(calclib STATIC src/calclib.cpp include/calc/lib.hpp)
target_include_directories(calclib PUBLIC include) target_include_directories(calclib PUBLIC include)
target_compile_features(calclib PUBLIC cxx_std_11) target_compile_features(calclib PUBLIC cxx_std_11)
@ -173,4 +173,3 @@ target_link_libraries(calc PUBLIC calclib)
[^2]: You will sometimes see `FATAL_ERROR` here, that was needed to support nice failures when running this in CMake <2.6, which should not be a problem anymore. [^2]: You will sometimes see `FATAL_ERROR` here, that was needed to support nice failures when running this in CMake <2.6, which should not be a problem anymore.
[^3]: The `::` syntax was originally intended for `INTERFACE IMPORTED` libraries, which were explicitly supposed to be libraries defined outside the current project. But, because of this, most of the `target_*` commands don't work on `IMPORTED` libraries, making them hard to set up yourself. So don't use the `IMPORTED` keyword for now, and use an `ALIAS` target instead; it will be fine until you start exporting targets. This limitation was fixed in CMake 3.11. [^3]: The `::` syntax was originally intended for `INTERFACE IMPORTED` libraries, which were explicitly supposed to be libraries defined outside the current project. But, because of this, most of the `target_*` commands don't work on `IMPORTED` libraries, making them hard to set up yourself. So don't use the `IMPORTED` keyword for now, and use an `ALIAS` target instead; it will be fine until you start exporting targets. This limitation was fixed in CMake 3.11.

View File

@ -51,4 +51,3 @@ project(My LANGUAGES CXX VERSION ${VERSION_STRING})
``` ```
Above, `file(STRINGS file_name variable_name REGEX regex)` picks lines that match a regex; and the same regex is used to then pick out the parentheses capture group with the version part. Replace is used with back substitution to output only that one group. Above, `file(STRINGS file_name variable_name REGEX regex)` picks lines that match a regex; and the same regex is used to then pick out the parentheses capture group with the version part. Replace is used with back substitution to output only that one group.

View File

@ -1,10 +1,10 @@
# A simple example # A simple example
This is a simple yet complete example of a proper CMakeLists. For this program, we have one library (MyLibExample) with a header file and a source file, This is a simple yet complete example of a proper CMakeLists. For this program, we have one library (MyLibExample) with a header file and a source file,
and one application, MyExample, with one source file. and one application, MyExample, with one source file.
[import:'main', lang:'cmake'](../../examples/simple-project/CMakeLists.txt) [import:'main', lang:'cmake'](../../examples/simple-project/CMakeLists.txt)
The complete example is available in [examples folder](https://gitlab.com/CLIUtils/modern-cmake/tree/master/examples/simple-project). The complete example is available in [examples folder](https://gitlab.com/CLIUtils/modern-cmake/tree/master/examples/simple-project).
A larger, multi-file example is [also available](https://gitlab.com/CLIUtils/modern-cmake/tree/master/examples/extended-project). A larger, multi-file example is [also available](https://gitlab.com/CLIUtils/modern-cmake/tree/master/examples/extended-project).

View File

@ -114,4 +114,4 @@ If you look at the official page, you'll see a slightly different method using s
[^1]: They act as if they are evaluated at build/install time, though actually they are evaluated for each build configuration. [^1]: They act as if they are evaluated at build/install time, though actually they are evaluated for each build configuration.
[^2]: The CMake docs splits expressions into Informational, Logical, and Output. [^2]: The CMake docs splits expressions into Informational, Logical, and Output.

View File

@ -42,4 +42,3 @@ Here, the generation happens after `some_target` is complete, and happens when y
A useful tool in writing CMake builds that work cross-platform is `cmake -E <mode>` (seen in CMake files as `${CMAKE_COMMAND} -E`). This mode allows CMake to do a variety of things without calling system tools explicitly, like `copy`, `make_directory`, and `remove`. It is mostly used for the build time commands. Note that the very useful `create_symlink` mode used to be Unix only, but was added for Windows in CMake 3.13. [See the docs](https://cmake.org/cmake/help/latest/manual/cmake.1.html#command-line-tool-mode). A useful tool in writing CMake builds that work cross-platform is `cmake -E <mode>` (seen in CMake files as `${CMAKE_COMMAND} -E`). This mode allows CMake to do a variety of things without calling system tools explicitly, like `copy`, `make_directory`, and `remove`. It is mostly used for the build time commands. Note that the very useful `create_symlink` mode used to be Unix only, but was added for Windows in CMake 3.13. [See the docs](https://cmake.org/cmake/help/latest/manual/cmake.1.html#command-line-tool-mode).
[execute_process]: https://cmake.org/cmake/help/latest/command/execute_process.html [execute_process]: https://cmake.org/cmake/help/latest/command/execute_process.html

View File

@ -62,4 +62,3 @@ endif()
``` ```
See the [extended code example here](https://gitlab.com/CLIUtils/modern-cmake/tree/master/examples/extended-project). See the [extended code example here](https://gitlab.com/CLIUtils/modern-cmake/tree/master/examples/extended-project).

View File

@ -51,8 +51,8 @@ Since `BOOL` is such a common variable type, you can set it more succinctly with
```cmake ```cmake
option(MY_OPTION "This is settable from the command line" OFF) option(MY_OPTION "This is settable from the command line" OFF)
``` ```
For the `BOOL` datatype, there are several different wordings for `ON` and `OFF`. For the `BOOL` datatype, there are several different wordings for `ON` and `OFF`.
See [cmake-variables] for a listing of known variables in CMake. See [cmake-variables] for a listing of known variables in CMake.
@ -62,8 +62,8 @@ See [cmake-variables] for a listing of known variables in CMake.
You can also `set(ENV{variable_name} value)` and get `$ENV{variable_name}` environment variables, though it is generally a very good idea to avoid them. You can also `set(ENV{variable_name} value)` and get `$ENV{variable_name}` environment variables, though it is generally a very good idea to avoid them.
## The Cache ## The Cache
The cache is actually just a text file, `CMakeCache.txt`, that gets created in the build directory when you run CMake. This is how CMake remembers anything you set, so you don't have to re-list your options every time you rerun CMake. The cache is actually just a text file, `CMakeCache.txt`, that gets created in the build directory when you run CMake. This is how CMake remembers anything you set, so you don't have to re-list your options every time you rerun CMake.
## Properties ## Properties

View File

@ -49,4 +49,3 @@ If you add `--trace-expand`, the variables will be expanded into their values.
For single-configuration generators, you can build your code with `-DCMAKE_BUILD_TYPE=Debug` to get debugging flags. In multi-configuration generators, like many IDEs, you can pick the configuration in the IDE. There are distinct flags for this mode (variables ending in `_DEBUG` as opposed to `_RELEASE`), as well as a generator expression value `CONFIG:Debug` or `CONFIG:Release`. For single-configuration generators, you can build your code with `-DCMAKE_BUILD_TYPE=Debug` to get debugging flags. In multi-configuration generators, like many IDEs, you can pick the configuration in the IDE. There are distinct flags for this mode (variables ending in `_DEBUG` as opposed to `_RELEASE`), as well as a generator expression value `CONFIG:Debug` or `CONFIG:Release`.
Once you make a debug build, you can run a debugger, such as gdb or lldb on it. Once you make a debug build, you can run a debugger, such as gdb or lldb on it.

View File

@ -24,7 +24,7 @@ You can control how files show up in each folder with regular expressions or exp
## Folders for files ## Folders for files
You can also control how the folders inside targets appear. There are two ways, both using the «command:source_group» command. The traditional way is You can also control how the folders inside targets appear. There are two ways, both using the «command:source_group» command. The traditional way is
```cmake ```cmake
source_group("Source Files\\New Directory" REGULAR_EXPRESSION ".*\\.c[ucp]p?") source_group("Source Files\\New Directory" REGULAR_EXPRESSION ".*\\.c[ucp]p?")

View File

@ -84,7 +84,7 @@ try_compile(
bindir bindir
SOURCES SOURCES
source.cpp source.cpp
) )
``` ```
There are lots of options you can add, like `COMPILE_DEFINITIONS`. In CMake 3.8+, this will honor the CMake C/C++/CUDA standard settings. If you use `try_run` instead, it will run the resulting program and give you the output in `RUN_OUTPUT_VARIABLE`. There are lots of options you can add, like `COMPILE_DEFINITIONS`. In CMake 3.8+, this will honor the CMake C/C++/CUDA standard settings. If you use `try_run` instead, it will run the resulting program and give you the output in `RUN_OUTPUT_VARIABLE`.

View File

@ -22,4 +22,3 @@ export(PACKAGE MyLib)
Now, if you `find_package(MyLib)`, CMake can find the build folder. Look at the generated `MyLibTargets.cmake` file to help you understand exactly what is created; it's just a normal CMake file, with the exported targets. Now, if you `find_package(MyLib)`, CMake can find the build folder. Look at the generated `MyLibTargets.cmake` file to help you understand exactly what is created; it's just a normal CMake file, with the exported targets.
Note that there's a downside: if you have imported dependencies, they will need to be imported before you `find_package`. That will be fixed in the next method. Note that there's a downside: if you have imported dependencies, they will need to be imported before you `find_package`. That will be fixed in the next method.

View File

@ -55,7 +55,7 @@ find_dependency(MYDEP REQUIRED)
include("${CMAKE_CURRENT_LIST_DIR}/MyLibTargets.cmake") include("${CMAKE_CURRENT_LIST_DIR}/MyLibTargets.cmake")
``` ```
Now, you can use configure file (if you used a `.in` file) and then install the resulting file. Now, you can use configure file (if you used a `.in` file) and then install the resulting file.
Since we've made a `ConfigVersion` file, this is a good place to install it too. Since we've made a `ConfigVersion` file, this is a good place to install it too.
```cmake ```cmake

View File

@ -34,4 +34,3 @@ Finally, you need to include the CPack module:
```cmake ```cmake
include(CPack) include(CPack)
``` ```

View File

@ -8,7 +8,7 @@ The next two lists are heavily based on the excellent gist [Effective Modern CMa
* **Don't add unneeded PUBLIC requirements**: You should avoid forcing something on users that is not required (`-Wall`). Make these PRIVATE instead. * **Don't add unneeded PUBLIC requirements**: You should avoid forcing something on users that is not required (`-Wall`). Make these PRIVATE instead.
* **Don't GLOB files**: Make or another tool will not know if you add files without rerunning CMake. Note that CMake 3.12 adds a `CONFIGURE_DEPENDS` flag that makes this far better if you need to use it. * **Don't GLOB files**: Make or another tool will not know if you add files without rerunning CMake. Note that CMake 3.12 adds a `CONFIGURE_DEPENDS` flag that makes this far better if you need to use it.
* **Link to built files directly**: Always link to targets if available. * **Link to built files directly**: Always link to targets if available.
* **Never skip PUBLIC/PRIVATE when linking**: This causes all future linking to be keyword-less. * **Never skip PUBLIC/PRIVATE when linking**: This causes all future linking to be keyword-less.
## CMake Patterns ## CMake Patterns

View File

@ -120,7 +120,7 @@ You should only use the default CMake on 18.04+; it's an LTS release with a pret
Just `pip install cmake` on many systems. Add `--user` if you have to. ManyLinux1 (old pip or OS) gets CMake 3.13.3. Just `pip install cmake` on many systems. Add `--user` if you have to. ManyLinux1 (old pip or OS) gets CMake 3.13.3.
### CI ### CI
| Distribution | CMake version | Notes | | Distribution | CMake version | Notes |
|---------------|---------------|-------| |---------------|---------------|-------|

View File

@ -79,7 +79,7 @@ This release added Clang-Tidy support, along with more utilities and improvement
* External projects can now be shallow clones, and other improvements * External projects can now be shallow clones, and other improvements
## [CMake 3.7][] : Android & CMake Server ## [CMake 3.7][] : Android & CMake Server
You can now cross-compile to Android. Useful new if statement options really help clarify code. And the new server mode was supposed to improve integration with IDEs (but is being replaced by a different system in CMake 3.14+). Support for the VIM editor was also improved. You can now cross-compile to Android. Useful new if statement options really help clarify code. And the new server mode was supposed to improve integration with IDEs (but is being replaced by a different system in CMake 3.14+). Support for the VIM editor was also improved.
@ -95,7 +95,7 @@ You can now cross-compile to Android. Useful new if statement options really hel
## [CMake 3.8][] : C# & CUDA ## [CMake 3.8][] : C# & CUDA
This adds CUDA as a language, as well as `cxx_std_11` as a compiler meta-feature. The new generator expression could be really useful if you can require CMake 3.8+! This adds CUDA as a language, as well as `cxx_std_11` as a compiler meta-feature. The new generator expression could be really useful if you can require CMake 3.8+!
* Initially released [April 10, 2017](https://blog.kitware.com/cmake-3-8-0-available-for-download/) * Initially released [April 10, 2017](https://blog.kitware.com/cmake-3-8-0-available-for-download/)
* Native support for C# as a language * Native support for C# as a language
@ -157,7 +157,7 @@ Very powerful release, containing lots of smaller long-requested features. One o
but immediately noticeable changes is the addition of version ranges; but immediately noticeable changes is the addition of version ranges;
you can now set both the minimum and maximum known CMake version easily. You can also set you can now set both the minimum and maximum known CMake version easily. You can also set
`CONFIGURE_DEPENDS` on a `GLOB`ed set of files, and the build system will check those files and `CONFIGURE_DEPENDS` on a `GLOB`ed set of files, and the build system will check those files and
rerun if needed! You can use the general `PackageName_ROOT` rerun if needed! You can use the general `PackageName_ROOT`
for all `find_package` searches. Lots of additions to strings and lists, module updates, for all `find_package` searches. Lots of additions to strings and lists, module updates,
shiny new Python find module (2 and 3 versions too), and many more. shiny new Python find module (2 and 3 versions too), and many more.
@ -195,7 +195,7 @@ of the source directory, for better file separation. And, `target_sources` *fina
## [CMake 3.14][] : File utilities (AKA [CMake π](https://blog.kitware.com/kitware-gets-mathematical-with-cmake-π-on-pi-day/)) ## [CMake 3.14][] : File utilities (AKA [CMake π](https://blog.kitware.com/kitware-gets-mathematical-with-cmake-π-on-pi-day/))
This release has lots of small cleanups, including several utilities for files. Generator expressions work in a few more places, and list handling is better with empty variables. This release has lots of small cleanups, including several utilities for files. Generator expressions work in a few more places, and list handling is better with empty variables.
Quite a few more find packages produce targets. The new Visual Studio 16 2019 generator is a bit different than older versions. Windows XP and Vista support has been dropped. Quite a few more find packages produce targets. The new Visual Studio 16 2019 generator is a bit different than older versions. Windows XP and Vista support has been dropped.
* Initially released [March 14, 2019](https://blog.kitware.com/cmake-3-14-0-available-for-download/) * Initially released [March 14, 2019](https://blog.kitware.com/cmake-3-14-0-available-for-download/)
@ -241,7 +241,7 @@ fixes were implemented, especially to newer features, such as to FindPython, Fin
A FindCUDAToolkit was finally added, which allows finding and using the CUDA A FindCUDAToolkit was finally added, which allows finding and using the CUDA
toolkit without enabling the CUDA language! CUDA now is a bit more configurable, toolkit without enabling the CUDA language! CUDA now is a bit more configurable,
such as linking to shared libraries. Quite a bit more polish in the expected areas, such as linking to shared libraries. Quite a bit more polish in the expected areas,
as well, like FindPython. Finally, you can now iterate over multiple lists at a time. as well, like FindPython. Finally, you can now iterate over multiple lists at a time.
* Initially released [March 20, 2020](https://blog.kitware.com/cmake-3-17-0-available-for-download/) * Initially released [March 20, 2020](https://blog.kitware.com/cmake-3-17-0-available-for-download/)
@ -283,19 +283,19 @@ features and papercut fixes are sprinkled throughout, a small selection is below
[Releases]: https://cmake.org/cmake/help/latest/release/index.html [Releases]: https://cmake.org/cmake/help/latest/release/index.html
[CMake 3.0]: https://cmake.org/cmake/help/latest/release/3.0.html [CMake 3.0]: https://cmake.org/cmake/help/latest/release/3.0.html
[CMake 3.1]: https://cmake.org/cmake/help/latest/release/3.1.html [CMake 3.1]: https://cmake.org/cmake/help/latest/release/3.1.html
[CMake 3.2]: https://cmake.org/cmake/help/latest/release/3.2.html [CMake 3.2]: https://cmake.org/cmake/help/latest/release/3.2.html
[CMake 3.3]: https://cmake.org/cmake/help/latest/release/3.3.html [CMake 3.3]: https://cmake.org/cmake/help/latest/release/3.3.html
[CMake 3.4]: https://cmake.org/cmake/help/latest/release/3.4.html [CMake 3.4]: https://cmake.org/cmake/help/latest/release/3.4.html
[CMake 3.5]: https://cmake.org/cmake/help/latest/release/3.5.html [CMake 3.5]: https://cmake.org/cmake/help/latest/release/3.5.html
[CMake 3.6]: https://cmake.org/cmake/help/latest/release/3.6.html [CMake 3.6]: https://cmake.org/cmake/help/latest/release/3.6.html
[CMake 3.7]: https://cmake.org/cmake/help/latest/release/3.7.html [CMake 3.7]: https://cmake.org/cmake/help/latest/release/3.7.html
[CMake 3.8]: https://cmake.org/cmake/help/latest/release/3.8.html [CMake 3.8]: https://cmake.org/cmake/help/latest/release/3.8.html
[CMake 3.9]: https://cmake.org/cmake/help/latest/release/3.9.html [CMake 3.9]: https://cmake.org/cmake/help/latest/release/3.9.html
[CMake 3.10]: https://cmake.org/cmake/help/latest/release/3.10.html [CMake 3.10]: https://cmake.org/cmake/help/latest/release/3.10.html
[CMake 3.11]: https://cmake.org/cmake/help/latest/release/3.11.html [CMake 3.11]: https://cmake.org/cmake/help/latest/release/3.11.html
[CMake 3.12]: https://cmake.org/cmake/help/latest/release/3.12.html [CMake 3.12]: https://cmake.org/cmake/help/latest/release/3.12.html
[CMake 3.13]: https://cmake.org/cmake/help/latest/release/3.13.html [CMake 3.13]: https://cmake.org/cmake/help/latest/release/3.13.html
[CMake 3.14]: https://cmake.org/cmake/help/latest/release/3.14.html [CMake 3.14]: https://cmake.org/cmake/help/latest/release/3.14.html
[CMake 3.15]: https://cmake.org/cmake/help/latest/release/3.15.html [CMake 3.15]: https://cmake.org/cmake/help/latest/release/3.15.html

View File

@ -94,4 +94,3 @@ These are common CMake options to most packages:
## Debugging your CMake files ## Debugging your CMake files
We've already mentioned verbose output for the build, but you can also see verbose CMake configure output too. The `--trace` option will print every line of CMake that is run. Since this is very verbose, CMake 3.7 added `--trace-source="filename"`, which will print out every executed line of just the file you are interested in when it runs. If you select the name of the file you are interested in debugging (usually by selecting the parent directory when debugging a CMakeLists.txt, since all of those have the same name), you can just see the lines that run in that file. Very useful! We've already mentioned verbose output for the build, but you can also see verbose CMake configure output too. The `--trace` option will print every line of CMake that is run. Since this is very verbose, CMake 3.7 added `--trace-source="filename"`, which will print out every executed line of just the file you are interested in when it runs. If you select the name of the file you are interested in debugging (usually by selecting the parent directory when debugging a CMakeLists.txt, since all of those have the same name), you can just see the lines that run in that file. Very useful!

View File

@ -28,7 +28,7 @@ check_language(CUDA)
``` ```
You can see if CUDA is present by checking `CMAKE_CUDA_COMPILER` (was missing You can see if CUDA is present by checking `CMAKE_CUDA_COMPILER` (was missing
until CMake 3.11). until CMake 3.11).
You can check variables like `CMAKE_CUDA_COMPILER_ID` (for nvcc, this is You can check variables like `CMAKE_CUDA_COMPILER_ID` (for nvcc, this is
`"NVIDIA"`, Clang was added in CMake 3.18). You can check the version with `"NVIDIA"`, Clang was added in CMake 3.18). You can check the version with
@ -63,7 +63,7 @@ set_target_properties(mylib PROPERTIES
You can also directly make a PTX file with the `CUDA_PTX_COMPILATION` property. You can also directly make a PTX file with the `CUDA_PTX_COMPILATION` property.
### Targeting architectures ### Targeting architectures
When you build CUDA code, you generally should be targeting an architecture. If you don't, you compile 'ptx', which provide the basic instructions but is compiled at runtime, making it potentially much slower to load. When you build CUDA code, you generally should be targeting an architecture. If you don't, you compile 'ptx', which provide the basic instructions but is compiled at runtime, making it potentially much slower to load.
@ -106,7 +106,7 @@ to find a variety of useful targets and variables even without enabling the
CUDA language. CUDA language.
> ### Note that FindCUDA is deprecated, but for for versions of CMake < 3.18, the following functions required FindCUDA: > ### Note that FindCUDA is deprecated, but for for versions of CMake < 3.18, the following functions required FindCUDA:
> >
> * CUDA version checks / picking a version > * CUDA version checks / picking a version
> * Architecture detection (Note: 3.12 fixes this partially) > * Architecture detection (Note: 3.12 fixes this partially)
> * Linking to CUDA libraries from non-.cu files > * Linking to CUDA libraries from non-.cu files
@ -133,5 +133,3 @@ You'll also might want to allow a user to check for the arch flags of their curr
```cmake ```cmake
cuda_select_nvcc_arch_flags(ARCH_FLAGS) # optional argument for arch to add cuda_select_nvcc_arch_flags(ARCH_FLAGS) # optional argument for arch to add
``` ```

View File

@ -90,7 +90,7 @@ The final argument, listed after `LINKDEF`, must have a name that ends in `LinkD
* `lib{NAME}.rootmap` (`G__` prefix removed): The rootmap file in plain text * `lib{NAME}.rootmap` (`G__` prefix removed): The rootmap file in plain text
* `lib{NAME}_rdict.pcm` (`G__` prefix removed): A ROOT file * `lib{NAME}_rdict.pcm` (`G__` prefix removed): A ROOT file
The final two output files must sit next to the library output. This is done by checking `CMAKE_LIBRARY_OUTPUT_DIRECTORY` (it will not pick up local target settings). If you have a libdir set but you don't have (global) install locations set, you'll also need to set `ARG_NOINSTALL` to `TRUE`. The final two output files must sit next to the library output. This is done by checking `CMAKE_LIBRARY_OUTPUT_DIRECTORY` (it will not pick up local target settings). If you have a libdir set but you don't have (global) install locations set, you'll also need to set `ARG_NOINSTALL` to `TRUE`.
[linkdef-root]: https://root.cern.ch/selecting-dictionary-entries-linkdefh [linkdef-root]: https://root.cern.ch/selecting-dictionary-entries-linkdefh
@ -132,4 +132,3 @@ set_property(TARGET ROOT::Flags_CXX APPEND PROPERTY
# Make sure you link with ROOT::Flags_CXX too! # Make sure you link with ROOT::Flags_CXX too!
``` ```

View File

@ -3,5 +3,4 @@
This is where a good Git system plus CMake shines. You might not be able to solve all the world's problems, but This is where a good Git system plus CMake shines. You might not be able to solve all the world's problems, but
this is pretty close for C++! this is pretty close for C++!
There are several methods listed in the chapters in this section. There are several methods listed in the chapters in this section.

View File

@ -10,4 +10,4 @@ Until CMake 3.11, the primary download method for packages was done at build tim
## Downloading Method: configure time ## Downloading Method: configure time
If you prefer configure time, see the [Crascit/DownloadProject](https://github.com/Crascit/DownloadProject) repository for a drop-in solution. Submodules work so well, though, that I've discontinued most of the downloads for things like GoogleTest and moved them to submodules. Auto downloads are harder to mimic if you If you prefer configure time, see the [Crascit/DownloadProject](https://github.com/Crascit/DownloadProject) repository for a drop-in solution. Submodules work so well, though, that I've discontinued most of the downloads for things like GoogleTest and moved them to submodules. Auto downloads are harder to mimic if you
don't have internet access, and they are often implemented in the build directory, wasting time and space if you have multiple build directories. don't have internet access, and they are often implemented in the build directory, wasting time and space if you have multiple build directories.

View File

@ -49,4 +49,3 @@ endif()
Now you have the CMake 3.14+ syntax in CMake 3.11+. Now you have the CMake 3.14+ syntax in CMake 3.11+.
[FetchContent]: https://cmake.org/cmake/help/latest/module/FetchContent.html [FetchContent]: https://cmake.org/cmake/help/latest/module/FetchContent.html

View File

@ -2,46 +2,45 @@
cmake_minimum_required(VERSION 3.11...3.16) cmake_minimum_required(VERSION 3.11...3.16)
# Project name and a few useful settings. Other commands can pick up the results # Project name and a few useful settings. Other commands can pick up the results
project(ModernCMakeExample project(
VERSION 0.1 ModernCMakeExample
DESCRIPTION "An example project with CMake" VERSION 0.1
LANGUAGES CXX) DESCRIPTION "An example project with CMake"
LANGUAGES CXX)
# Only do these if this is the main project, and not if it is included through add_subdirectory # Only do these if this is the main project, and not if it is included through add_subdirectory
if(CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME) if(CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)
# Optionally set things like CMAKE_CXX_STANDARD, CMAKE_POSITION_INDEPENDENT_CODE here # Optionally set things like CMAKE_CXX_STANDARD, CMAKE_POSITION_INDEPENDENT_CODE here
# Let's ensure -std=c++xx instead of -std=g++xx
set(CMAKE_CXX_EXTENSIONS OFF)
# Let's nicely support folders in IDEs # Let's ensure -std=c++xx instead of -std=g++xx
set_property(GLOBAL PROPERTY USE_FOLDERS ON) set(CMAKE_CXX_EXTENSIONS OFF)
# Testing only available if this is the main app # Let's nicely support folders in IDEs
# Note this needs to be done in the main CMakeLists set_property(GLOBAL PROPERTY USE_FOLDERS ON)
# since it calls enable_testing, which must be in the
# main CMakeLists.
include(CTest)
# Docs only available if this is the main app # Testing only available if this is the main app
find_package(Doxygen) # Note this needs to be done in the main CMakeLists
if(Doxygen_FOUND) # since it calls enable_testing, which must be in the
add_subdirectory(docs) # main CMakeLists.
else() include(CTest)
message(STATUS "Doxygen not found, not building docs")
endif() # Docs only available if this is the main app
find_package(Doxygen)
if(Doxygen_FOUND)
add_subdirectory(docs)
else()
message(STATUS "Doxygen not found, not building docs")
endif()
endif() endif()
# FetchContent added in CMake 3.11, downloads during the configure step # FetchContent added in CMake 3.11, downloads during the configure step
include(FetchContent) include(FetchContent)
# FetchContent_MakeAvailable was not added until CMake 3.14; use our shim # FetchContent_MakeAvailable was not added until CMake 3.14; use our shim
if(${CMAKE_VERSION} VERSION_LESS 3.14) if(${CMAKE_VERSION} VERSION_LESS 3.14)
include(cmake/add_FetchContent_MakeAvailable.cmake) include(cmake/add_FetchContent_MakeAvailable.cmake)
endif() endif()
# Accumulator library # Accumulator library
# This is header only, so could be replaced with git submodules or FetchContent # This is header only, so could be replaced with git submodules or FetchContent
find_package(Boost REQUIRED) find_package(Boost REQUIRED)
@ -51,8 +50,7 @@ find_package(Boost REQUIRED)
FetchContent_Declare( FetchContent_Declare(
fmtlib fmtlib
GIT_REPOSITORY https://github.com/fmtlib/fmt.git GIT_REPOSITORY https://github.com/fmtlib/fmt.git
GIT_TAG 5.3.0 GIT_TAG 5.3.0)
)
FetchContent_MakeAvailable(fmtlib) FetchContent_MakeAvailable(fmtlib)
# Adds fmt::fmt # Adds fmt::fmt
@ -64,7 +62,7 @@ add_subdirectory(apps)
# Testing only available if this is the main app # Testing only available if this is the main app
# Emergency override MODERN_CMAKE_BUILD_TESTING provided as well # Emergency override MODERN_CMAKE_BUILD_TESTING provided as well
if((CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME OR MODERN_CMAKE_BUILD_TESTING) AND BUILD_TESTING) if((CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME OR MODERN_CMAKE_BUILD_TESTING)
add_subdirectory(tests) AND BUILD_TESTING)
add_subdirectory(tests)
endif() endif()

View File

@ -8,7 +8,7 @@
int main() { int main() {
std::vector<double> input = {1.2, 2.3, 3.4, 4.5}; std::vector<double> input = {1.2, 2.3, 3.4, 4.5};
auto [mean, moment] = accumulate_vector(input); auto [mean, moment] = accumulate_vector(input);
fmt::print("Mean: {}, Moment: {}\n", mean, moment); fmt::print("Mean: {}, Moment: {}\n", mean, moment);

View File

@ -1,8 +1,7 @@
macro(FetchContent_MakeAvailable NAME) macro(FetchContent_MakeAvailable NAME)
FetchContent_GetProperties(${NAME}) FetchContent_GetProperties(${NAME})
if(NOT ${NAME}_POPULATED) if(NOT ${NAME}_POPULATED)
FetchContent_Populate(${NAME}) FetchContent_Populate(${NAME})
add_subdirectory(${${NAME}_SOURCE_DIR} ${${NAME}_BINARY_DIR}) add_subdirectory(${${NAME}_SOURCE_DIR} ${${NAME}_BINARY_DIR})
endif() endif()
endmacro() endmacro()

View File

@ -1,9 +1,5 @@
set(DOXYGEN_EXTRACT_ALL YES) set(DOXYGEN_EXTRACT_ALL YES)
set(DOXYGEN_BUILTIN_STL_SUPPORT YES) set(DOXYGEN_BUILTIN_STL_SUPPORT YES)
doxygen_add_docs(docs doxygen_add_docs(docs modern/lib.hpp "${CMAKE_CURRENT_SOURCE_DIR}/mainpage.md"
modern/lib.hpp WORKING_DIRECTORY "${PROJECT_SOURCE_DIR}/include")
"${CMAKE_CURRENT_SOURCE_DIR}/mainpage.md"
WORKING_DIRECTORY
"${PROJECT_SOURCE_DIR}/include"
)

View File

@ -10,5 +10,3 @@
std::tuple<double, double> accumulate_vector( std::tuple<double, double> accumulate_vector(
const std::vector<double>& values ///< The vector of values const std::vector<double>& values ///< The vector of values
); );

View File

@ -1,4 +1,3 @@
# Note that headers are optional, and do not affect add_library, but they will not # Note that headers are optional, and do not affect add_library, but they will not
# show up in IDEs unless they are listed in add_library. # show up in IDEs unless they are listed in add_library.
@ -19,4 +18,7 @@ target_link_libraries(modern_library PRIVATE Boost::boost)
target_compile_features(modern_library PUBLIC cxx_std_11) target_compile_features(modern_library PUBLIC cxx_std_11)
# IDEs should put the headers in a nice place # IDEs should put the headers in a nice place
source_group(TREE "${PROJECT_SOURCE_DIR}/include" PREFIX "Header Files" FILES ${HEADER_LIST}) source_group(
TREE "${PROJECT_SOURCE_DIR}/include"
PREFIX "Header Files"
FILES ${HEADER_LIST})

View File

@ -1,10 +1,8 @@
# Testing library # Testing library
FetchContent_Declare( FetchContent_Declare(
catch2 catch2
GIT_REPOSITORY https://github.com/catchorg/Catch2.git GIT_REPOSITORY https://github.com/catchorg/Catch2.git
GIT_TAG v2.9.1 GIT_TAG v2.9.1)
)
FetchContent_MakeAvailable(catch2) FetchContent_MakeAvailable(catch2)
# Adds Catch2::Catch2 # Adds Catch2::Catch2

View File

@ -9,4 +9,3 @@ TEST_CASE( "Quick check", "[main]" ) {
REQUIRE( mean == 2.0 ); REQUIRE( mean == 2.0 );
REQUIRE( moment == Approx(4.666666) ); REQUIRE( moment == Approx(4.666666) );
} }

View File

@ -1,4 +1,3 @@
## [main] ## [main]
cmake_minimum_required(VERSION 3.4...3.16) cmake_minimum_required(VERSION 3.4...3.16)
@ -28,6 +27,7 @@ message(STATUS "Original definitions: ${ROOT_DEFINITIONS}")
message(STATUS "Original exe flags: ${ROOT_EXE_LINKER_FLAGS}") message(STATUS "Original exe flags: ${ROOT_EXE_LINKER_FLAGS}")
enable_testing() enable_testing()
add_test(NAME RootDictExample add_test(
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" NAME RootDictExample
COMMAND "${ROOT_root_CMD}" -b -l -q "${CMAKE_CURRENT_SOURCE_DIR}/CheckLoad.C") WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMAND "${ROOT_root_CMD}" -b -l -q "${CMAKE_CURRENT_SOURCE_DIR}/CheckLoad.C")

View File

@ -1,4 +1,3 @@
## [main] ## [main]
cmake_minimum_required(VERSION 3.1...3.16) cmake_minimum_required(VERSION 3.1...3.16)
@ -9,7 +8,6 @@ project(RootSimpleExample LANGUAGES CXX)
find_package(ROOT 6.16 CONFIG REQUIRED) find_package(ROOT 6.16 CONFIG REQUIRED)
## [find_package] ## [find_package]
# Adding an executable program and linking to needed ROOT libraries # Adding an executable program and linking to needed ROOT libraries
## [add_and_link] ## [add_and_link]
add_executable(RootSimpleExample SimpleExample.cxx) add_executable(RootSimpleExample SimpleExample.cxx)

View File

@ -1,4 +1,3 @@
## [main] ## [main]
cmake_minimum_required(VERSION 3.1...3.16) cmake_minimum_required(VERSION 3.1...3.16)
@ -17,7 +16,8 @@ include("${ROOT_USE_FILE}")
separate_arguments(ROOT_EXE_LINKER_FLAGS) separate_arguments(ROOT_EXE_LINKER_FLAGS)
add_executable(RootUseFileExample SimpleExample.cxx) add_executable(RootUseFileExample SimpleExample.cxx)
target_link_libraries(RootUseFileExample PUBLIC ${ROOT_LIBRARIES} ${ROOT_EXE_LINKER_FLAGS}) target_link_libraries(RootUseFileExample PUBLIC ${ROOT_LIBRARIES}
${ROOT_EXE_LINKER_FLAGS})
## [core] ## [core]
## [main] ## [main]

View File

@ -1,4 +1,3 @@
## [main] ## [main]
# Almost all CMake files should start with this # Almost all CMake files should start with this
@ -9,7 +8,10 @@ cmake_minimum_required(VERSION 3.1...3.16)
# This is your project statement. You should always list languages; # This is your project statement. You should always list languages;
# Listing the version is nice here since it sets lots of useful variables # Listing the version is nice here since it sets lots of useful variables
project(ModernCMakeExample VERSION 1.0 LANGUAGES CXX) project(
ModernCMakeExample
VERSION 1.0
LANGUAGES CXX)
# If you set any CMAKE_ variables, that can go here. # If you set any CMAKE_ variables, that can go here.
# (But usually don't do this, except maybe for C++ standard) # (But usually don't do this, except maybe for C++ standard)
@ -39,4 +41,3 @@ target_link_libraries(MyExample PRIVATE MyLibExample)
# you'll probably want tests too # you'll probably want tests too
enable_testing() enable_testing()
add_test(NAME MyExample COMMAND MyExample) add_test(NAME MyExample COMMAND MyExample)