From 5512e03562694ebfe571a3b6068a7d35d9ddfd7a Mon Sep 17 00:00:00 2001 From: "Friedrich W. H. Kossebau" Date: Sat, 17 Apr 2021 11:02:00 +0200 Subject: Modules docs: move rst docs into bracket comments CMake >= 3.0 supports bracket comments, and the reStructuredText integration code in sphinx/ext/ecm.py already supports extracting the docs from a bracket comment instead. Editing documentation without leading line comment markers is more simple, e,g. when reflowing text over lines. With ECM meanwhile requiring CMake 3.5 now it is possible to switch (and thus follow also the approach used by cmake itself). NO_CHANGELOG --- modules/ECMOptionalAddSubdirectory.cmake | 62 ++++++++++++++++---------------- 1 file changed, 31 insertions(+), 31 deletions(-) (limited to 'modules/ECMOptionalAddSubdirectory.cmake') diff --git a/modules/ECMOptionalAddSubdirectory.cmake b/modules/ECMOptionalAddSubdirectory.cmake index 5450e4e7..0eeb1d41 100644 --- a/modules/ECMOptionalAddSubdirectory.cmake +++ b/modules/ECMOptionalAddSubdirectory.cmake @@ -1,38 +1,38 @@ -#.rst: -# ECMOptionalAddSubdirectory -# -------------------------- -# -# Make subdirectories optional. -# -# :: -# -# ecm_optional_add_subdirectory() -# -# This behaves like add_subdirectory(), except that it does not complain if the -# directory does not exist. Additionally, if the directory does exist, it -# creates an option to allow the user to skip it. The option will be named -# BUILD_. -# -# This is useful for "meta-projects" that combine several mostly-independent -# sub-projects. -# -# If the CMake variable DISABLE_ALL_OPTIONAL_SUBDIRECTORIES is set to TRUE for -# the first CMake run on the project, all optional subdirectories will be -# disabled by default (but can of course be enabled via the respective options). -# For example, the following will disable all optional subdirectories except the -# one named "foo": -# -# .. code-block:: sh -# -# cmake -DDISABLE_ALL_OPTIONAL_SUBDIRECTORIES=TRUE -DBUILD_foo=TRUE myproject -# -# Since pre-1.0.0. - -#============================================================================= # SPDX-FileCopyrightText: 2007 Alexander Neundorf # # SPDX-License-Identifier: BSD-3-Clause +#[=======================================================================[.rst: +ECMOptionalAddSubdirectory +-------------------------- + +Make subdirectories optional. + +:: + + ecm_optional_add_subdirectory() + +This behaves like add_subdirectory(), except that it does not complain if the +directory does not exist. Additionally, if the directory does exist, it +creates an option to allow the user to skip it. The option will be named +BUILD_. + +This is useful for "meta-projects" that combine several mostly-independent +sub-projects. + +If the CMake variable DISABLE_ALL_OPTIONAL_SUBDIRECTORIES is set to TRUE for +the first CMake run on the project, all optional subdirectories will be +disabled by default (but can of course be enabled via the respective options). +For example, the following will disable all optional subdirectories except the +one named "foo": + +.. code-block:: sh + + cmake -DDISABLE_ALL_OPTIONAL_SUBDIRECTORIES=TRUE -DBUILD_foo=TRUE myproject + +Since pre-1.0.0. +#]=======================================================================] + function(ECM_OPTIONAL_ADD_SUBDIRECTORY _dir) get_filename_component(_fullPath ${_dir} ABSOLUTE) if(EXISTS ${_fullPath}/CMakeLists.txt) -- cgit v1.2.1