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

1 files changed, 32 insertions, 34 deletions

diff --git a/find-modules/FindSasl2.cmake b/find-modules/FindSasl2.cmake
index b89b0884..7693b0e9 100644
--- a/find-modules/FindSasl2.cmake
+++ b/find-modules/FindSasl2.cmake
@@ -1,40 +1,38 @@
-#.rst:
-# FindSasl2
-# ---------
-#
-# Try to find the SASL2 library.
-#
-# This will define the following variables:
-#
-# ``Sasl2_FOUND``
-#     System has SASL2.
-#
-# ``Sasl2_VERSION``
-#     The version of SASL2.
-#
-# ``Sasl2_INCLUDE_DIRS``
-#     This should be passed to target_include_directories() if
-#     the target is not used for linking.
-#
-# ``Sasl2_LIBRARIES``
-#     The SASL2 library.
-#     This can be passed to target_link_libraries() instead of
-#     the ``Sasl2::Sasl2`` target
-#
-# If ``Sasl2_FOUND`` is TRUE, the following imported target
-# will be available:
-#
-# ``Sasl2::Sasl2``
-#     The SASL2 library
-#
-# Since 5.41.0.
-#
-#=============================================================================
 # SPDX-FileCopyrightText: 2006, 2007 Laurent Montel <montel@kde.org>
 #
-#
 # SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
+
+#[=======================================================================[.rst:
+FindSasl2
+---------
+
+Try to find the SASL2 library.
+
+This will define the following variables:
+
+``Sasl2_FOUND``
+    System has SASL2.
+
+``Sasl2_VERSION``
+    The version of SASL2.
+
+``Sasl2_INCLUDE_DIRS``
+    This should be passed to target_include_directories() if
+    the target is not used for linking.
+
+``Sasl2_LIBRARIES``
+    The SASL2 library.
+    This can be passed to target_link_libraries() instead of
+    the ``Sasl2::Sasl2`` target
+
+If ``Sasl2_FOUND`` is TRUE, the following imported target
+will be available:
+
+``Sasl2::Sasl2``
+    The SASL2 library
+
+Since 5.41.0.
+#]=======================================================================]
 
 # NOTE: libsasl2.pc doesn't export the include dir.
 find_package(PkgConfig QUIET)