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, 45 insertions, 45 deletions

diff --git a/find-modules/FindGperf.cmake b/find-modules/FindGperf.cmake
index 10bb9cda..78dacb4b 100644
--- a/find-modules/FindGperf.cmake
+++ b/find-modules/FindGperf.cmake
@@ -1,51 +1,51 @@
-#.rst:
-# FindGperf
-# -----------
-#
-# Try to find GNU gperf.
-#
-# If the gperf executable is not in your PATH, you can provide
-# an alternative name or full path location with the ``Gperf_EXECUTABLE``
-# variable.
-#
-# This will define the following variables:
-#
-# ``Gperf_FOUND``
-#     True if gperf is available.
-#
-# ``Gperf_EXECUTABLE``
-#     The gperf executable.
-#
-# If ``Gperf_FOUND`` is TRUE, it will also define the following imported
-# target:
-#
-# ``GPerf::Gperf``
-#     The gperf executable.
-#
-# and the following public function:
-#
-#   ecm_gperf_generate(<GperfInput> <OutputFile> <OutputVariable>
-#                      [GENERATION_FLAGS <flags>])
-#
-# Run ``gperf`` on ``<GperfInput>`` to generate ``<OutputFile>``, adding it to
-# the ``<OutputVariable>`` variable which contains the source for the target
-# where ``<OutputFile>`` is going to be built.  The optional
-# ``GENERATION_FLAGS`` argument is needed to pass extra parameters to
-# ``gperf`` (note you cannot override that way the output file).
-#
-# A simple invocation would be:
-#
-# .. code-block:: cmake
-#
-#   ecm_gperf_generate(simple.gperf ${CMAKE_CURRENT_BINARY_DIR}/simple.h MySources)
-#
-# Since 5.35.0.
-
-#=============================================================================
 # SPDX-FileCopyrightText: 2016-2017 Pino Toscano <pino@kde.org>
 #
 # SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
+
+#[=======================================================================[.rst:
+FindGperf
+-----------
+
+Try to find GNU gperf.
+
+If the gperf executable is not in your PATH, you can provide
+an alternative name or full path location with the ``Gperf_EXECUTABLE``
+variable.
+
+This will define the following variables:
+
+``Gperf_FOUND``
+    True if gperf is available.
+
+``Gperf_EXECUTABLE``
+    The gperf executable.
+
+If ``Gperf_FOUND`` is TRUE, it will also define the following imported
+target:
+
+``GPerf::Gperf``
+    The gperf executable.
+
+and the following public function:
+::
+
+  ecm_gperf_generate(<GperfInput> <OutputFile> <OutputVariable>
+                     [GENERATION_FLAGS <flags>])
+
+Run ``gperf`` on ``<GperfInput>`` to generate ``<OutputFile>``, adding it to
+the ``<OutputVariable>`` variable which contains the source for the target
+where ``<OutputFile>`` is going to be built.  The optional
+``GENERATION_FLAGS`` argument is needed to pass extra parameters to
+``gperf`` (note you cannot override that way the output file).
+
+A simple invocation would be:
+
+.. code-block:: cmake
+
+  ecm_gperf_generate(simple.gperf ${CMAKE_CURRENT_BINARY_DIR}/simple.h MySources)
+
+Since 5.35.0.
+#]=======================================================================]
 
 include(${CMAKE_CURRENT_LIST_DIR}/ECMFindModuleHelpersStub.cmake)