aboutsummaryrefslogtreecommitdiff
path: root/find-modules/FindLibcap.cmake
diff options
context:
space:
mode:
authorFriedrich W. H. Kossebau <kossebau@kde.org>2021-04-17 11:02:00 +0200
committerFriedrich W. H. Kossebau <kossebau@kde.org>2021-04-23 17:49:14 +0000
commit5512e03562694ebfe571a3b6068a7d35d9ddfd7a (patch)
tree3caca041d3526c8427ec3065642b41a52ad8578c /find-modules/FindLibcap.cmake
parent38b5d046c4d42232d45bf4464167b2e6feea4cf7 (diff)
downloadextra-cmake-modules-5512e03562694ebfe571a3b6068a7d35d9ddfd7a.tar.gz
extra-cmake-modules-5512e03562694ebfe571a3b6068a7d35d9ddfd7a.tar.bz2
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
Diffstat (limited to 'find-modules/FindLibcap.cmake')
-rw-r--r--find-modules/FindLibcap.cmake39
1 files changed, 20 insertions, 19 deletions
diff --git a/find-modules/FindLibcap.cmake b/find-modules/FindLibcap.cmake
index a9fc2112..2433a76d 100644
--- a/find-modules/FindLibcap.cmake
+++ b/find-modules/FindLibcap.cmake
@@ -1,25 +1,26 @@
-#.rst:
-# FindLibcap
-# ----------
-# Try to find the setcap binary and cap libraries
-#
-# This will define:
-#
-# Libcap_FOUND - system has the cap library and setcap binary
-# Libcap_LIBRARIES - cap libraries to link against
-# SETCAP_EXECUTABLE - path of the setcap binary
-#
-# In addition, the following targets are defined:
-#
-# Libcap::SetCapabilities
-#
-# Since 5.80.0
-#
-#=====================================================================
# SPDX-FileCopyrightText: 2014 Hrvoje Senjan <hrvoje.senjan@gmail.com>
#
# SPDX-License-Identifier: BSD-3-Clause
-#=====================================================================
+
+#[=======================================================================[.rst:
+FindLibcap
+----------
+Try to find the setcap binary and cap libraries
+
+This will define:
+
+``Libcap_FOUND``
+ system has the cap library and setcap binary
+``Libcap_LIBRARIES``
+ cap libraries to link against
+``SETCAP_EXECUTABLE``
+ path of the setcap binary
+
+In addition, the following targets are defined:
+ ``Libcap::SetCapabilities``
+
+Since 5.80.0
+#]=======================================================================]
find_program(SETCAP_EXECUTABLE NAMES setcap DOC "The setcap executable")