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, 53 insertions, 54 deletions

diff --git a/find-modules/FindWayland.cmake b/find-modules/FindWayland.cmake
index 919b2aaa..4b6eb403 100644
--- a/find-modules/FindWayland.cmake
+++ b/find-modules/FindWayland.cmake
@@ -1,61 +1,60 @@
-#.rst:
-# FindWayland
-# -----------
-#
-# Try to find Wayland.
-#
-# This is a component-based find module, which makes use of the COMPONENTS
-# and OPTIONAL_COMPONENTS arguments to find_module.  The following components
-# are available::
-#
-#   Client  Server  Cursor  Egl
-#
-# If no components are specified, this module will act as though all components
-# were passed to OPTIONAL_COMPONENTS.
-#
-# This module will define the following variables, independently of the
-# components searched for or found:
-#
-# ``Wayland_FOUND``
-#     TRUE if (the requested version of) Wayland is available
-# ``Wayland_VERSION``
-#     Found Wayland version
-# ``Wayland_TARGETS``
-#     A list of all targets imported by this module (note that there may be more
-#     than the components that were requested)
-# ``Wayland_LIBRARIES``
-#     This can be passed to target_link_libraries() instead of the imported
-#     targets
-# ``Wayland_INCLUDE_DIRS``
-#     This should be passed to target_include_directories() if the targets are
-#     not used for linking
-# ``Wayland_DEFINITIONS``
-#     This should be passed to target_compile_options() if the targets are not
-#     used for linking
-# ``Wayland_DATADIR``
-#     The core wayland protocols data directory
-#     Since 5.73.0
-#
-# For each searched-for components, ``Wayland_<component>_FOUND`` will be set to
-# TRUE if the corresponding Wayland library was found, and FALSE otherwise.  If
-# ``Wayland_<component>_FOUND`` is TRUE, the imported target
-# ``Wayland::<component>`` will be defined.  This module will also attempt to
-# determine ``Wayland_*_VERSION`` variables for each imported target, although
-# ``Wayland_VERSION`` should normally be sufficient.
-#
-# In general we recommend using the imported targets, as they are easier to use
-# and provide more control.  Bear in mind, however, that if any target is in the
-# link interface of an exported library, it must be made available by the
-# package config file.
-#
-# Since pre-1.0.0.
-
-#=============================================================================
 # SPDX-FileCopyrightText: 2014 Alex Merry <alex.merry@kde.org>
 # SPDX-FileCopyrightText: 2014 Martin Gräßlin <mgraesslin@kde.org>
 #
 # SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
+
+#[=======================================================================[.rst:
+FindWayland
+-----------
+
+Try to find Wayland.
+
+This is a component-based find module, which makes use of the COMPONENTS
+and OPTIONAL_COMPONENTS arguments to find_module.  The following components
+are available::
+
+  Client  Server  Cursor  Egl
+
+If no components are specified, this module will act as though all components
+were passed to OPTIONAL_COMPONENTS.
+
+This module will define the following variables, independently of the
+components searched for or found:
+
+``Wayland_FOUND``
+    TRUE if (the requested version of) Wayland is available
+``Wayland_VERSION``
+    Found Wayland version
+``Wayland_TARGETS``
+    A list of all targets imported by this module (note that there may be more
+    than the components that were requested)
+``Wayland_LIBRARIES``
+    This can be passed to target_link_libraries() instead of the imported
+    targets
+``Wayland_INCLUDE_DIRS``
+    This should be passed to target_include_directories() if the targets are
+    not used for linking
+``Wayland_DEFINITIONS``
+    This should be passed to target_compile_options() if the targets are not
+    used for linking
+``Wayland_DATADIR``
+    The core wayland protocols data directory
+    Since 5.73.0
+
+For each searched-for components, ``Wayland_<component>_FOUND`` will be set to
+TRUE if the corresponding Wayland library was found, and FALSE otherwise.  If
+``Wayland_<component>_FOUND`` is TRUE, the imported target
+``Wayland::<component>`` will be defined.  This module will also attempt to
+determine ``Wayland_*_VERSION`` variables for each imported target, although
+``Wayland_VERSION`` should normally be sufficient.
+
+In general we recommend using the imported targets, as they are easier to use
+and provide more control.  Bear in mind, however, that if any target is in the
+link interface of an exported library, it must be made available by the
+package config file.
+
+Since pre-1.0.0.
+#]=======================================================================]
 
 include(${CMAKE_CURRENT_LIST_DIR}/ECMFindModuleHelpersStub.cmake)