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, 25 insertions, 24 deletions

diff --git a/find-modules/FindGradle.cmake b/find-modules/FindGradle.cmake
index 414ea661..6d8d6929 100644
--- a/find-modules/FindGradle.cmake
+++ b/find-modules/FindGradle.cmake
@@ -1,30 +1,31 @@
-#.rst:
-# FindGradle
-# ----------
-#
-# Provides the ability to build Android AAR libraries using Gradle.
-#
-# This relies on the Qt provided Gradle, so a Qt for Android installation
-# is required.
-#
-#   gradle_add_aar(<target>
-#                  BUIDLFILE build.gradle
-#                  NAME <aar-name>)
-#
-# This builds an Android AAR library using the given ``build.gradle`` file.
-#
-#   gradle_install_aar(<target>
-#                      DESTINATION <dest>)
-#
-# Installs a Android AAR library that has been created with ``gradle_add_aar``.
-#
-# Since 5.76.0.
-
-#=============================================================================
 # SPDX-FileCopyrightText: 2019 Volker Krause <vkrause@kde.org>
 #
 # SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
+
+#[=======================================================================[.rst:
+FindGradle
+----------
+
+Provides the ability to build Android AAR libraries using Gradle.
+
+This relies on the Qt provided Gradle, so a Qt for Android installation
+is required.
+::
+
+  gradle_add_aar(<target>
+                 BUIDLFILE build.gradle
+                 NAME <aar-name>)
+
+This builds an Android AAR library using the given ``build.gradle`` file.
+::
+
+  gradle_install_aar(<target>
+                     DESTINATION <dest>)
+
+Installs a Android AAR library that has been created with ``gradle_add_aar``.
+
+Since 5.76.0.
+#]=======================================================================]
 
 include(CMakeParseArguments)
 include(FindPackageHandleStandardArgs)