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, 26 insertions, 27 deletions

diff --git a/find-modules/FindFontconfig.cmake b/find-modules/FindFontconfig.cmake
index ee68b8fa..db5f1830 100644
--- a/find-modules/FindFontconfig.cmake
+++ b/find-modules/FindFontconfig.cmake
@@ -1,34 +1,33 @@
-#.rst:
-# FindFontconfig
-# --------------
-#
-# Try to find Fontconfig.
-# Once done this will define the following variables:
-#
-# ``Fontconfig_FOUND``
-#     True if Fontconfig is available
-# ``Fontconfig_INCLUDE_DIRS``
-#     The include directory to use for the Fontconfig headers
-# ``Fontconfig_LIBRARIES``
-#     The Fontconfig libraries for linking
-# ``Fontconfig_DEFINITIONS``
-#     Compiler switches required for using Fontconfig
-# ``Fontconfig_VERSION``
-#     The version of Fontconfig that has been found
-#
-# If ``Fontconfig_FOUND`` is TRUE, it will also define the following
-# imported target:
-#
-# ``Fontconfig::Fontconfig``
-#
-# Since 5.57.0.
-
-#=============================================================================
 # SPDX-FileCopyrightText: 2006, 2007 Laurent Montel <montel@kde.org>
 # SPDX-FileCopyrightText: 2018 Volker Krause <vkrause@kde.org>
 #
 # SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
+
+#[=======================================================================[.rst:
+FindFontconfig
+--------------
+
+Try to find Fontconfig.
+Once done this will define the following variables:
+
+``Fontconfig_FOUND``
+    True if Fontconfig is available
+``Fontconfig_INCLUDE_DIRS``
+    The include directory to use for the Fontconfig headers
+``Fontconfig_LIBRARIES``
+    The Fontconfig libraries for linking
+``Fontconfig_DEFINITIONS``
+    Compiler switches required for using Fontconfig
+``Fontconfig_VERSION``
+    The version of Fontconfig that has been found
+
+If ``Fontconfig_FOUND`` is TRUE, it will also define the following
+imported target:
+
+``Fontconfig::Fontconfig``
+
+Since 5.57.0.
+#]=======================================================================]
 
 # use pkg-config to get the directories and then use these values
 # in the FIND_PATH() and FIND_LIBRARY() calls