From c20d22c951e61a06701f6c2201add7c11915e7c5 Mon Sep 17 00:00:00 2001 From: Alex Merry Date: Thu, 10 Apr 2014 21:38:09 +0100 Subject: Add documentation generation using Sphinx This is deliberately modelled very closely on CMake's documentation system. It's a hefty patch, because it involved changing all the documentation to be in reStructuredText format. I also cleaned up the copyright/license statements at the same time. Note that the find modules contain the full license, due to the fact that ecm_use_find_module() copies them out of the ECM distribution. --- modules/ECMMarkAsTest.cmake | 35 ++++++++++++++++++++++++++--------- 1 file changed, 26 insertions(+), 9 deletions(-) (limited to 'modules/ECMMarkAsTest.cmake') diff --git a/modules/ECMMarkAsTest.cmake b/modules/ECMMarkAsTest.cmake index e20bfbfe..24b8cfc7 100644 --- a/modules/ECMMarkAsTest.cmake +++ b/modules/ECMMarkAsTest.cmake @@ -1,15 +1,32 @@ -# - Function for marking targets as being only for testing -# This module provides the function ECM_MARK_AS_TEST(). +#.rst: +# ECMMarkAsTest +# ------------- # -# The ECM_MARK_AS_TEST function is used to indicate that a target should only -# be built if the BUILD_TESTING option (provided by CTest) is enabled. +# Marks a target as only being required for tests. # -# ECM_MARK_AS_TEST( target1 target2 ... targetN ) +# :: # -# If BUILD_TESTING is False, then targets marked as tests are excluded from -# the ALL target. They are all part of the 'buildtests' target though, so -# even if building with BUILD_TESTING set to False, it is possible to build -# all tests by invoking the 'buildtests' target. +# ecm_mark_as_test( [ [...]]) +# +# This will cause the specified targets to not be built unless either +# BUILD_TESTING is set to ON or the user invokes the ``buildtests`` target. +# +# BUILD_TESTING is created as a cache variable by the CTest module and by the +# :kde-module:`KDECMakeSettings` module. + +#============================================================================= +# Copyright 2012 Stephen Kelly +# Copyright 2012 Alex Neundorf +# +# Distributed under the OSI-approved BSD License (the "License"); +# see accompanying file COPYING-CMAKE-SCRIPTS for details. +# +# This software is distributed WITHOUT ANY WARRANTY; without even the +# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the License for more information. +#============================================================================= +# (To distribute this file outside of extra-cmake-modules, substitute the full +# License text for the above reference.) if (NOT BUILD_TESTING) if(NOT TARGET buildtests) -- cgit v1.2.1