UseSWIG: Convert docs to a bracket comment

Modules/UseSWIG.cmake

@@ -1,58 +1,59 @@
 # Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
 # file Copyright.txt or https://cmake.org/licensing for details.
 
-#.rst:
-# UseSWIG
-# -------
-#
-# Defines the following macros for use with SWIG:
-#
-# ::
-#
-#    SWIG_ADD_LIBRARY(<name>
-#                     [TYPE <SHARED|MODULE|STATIC|USE_BUILD_SHARED_LIBS>]
-#                     LANGUAGE <language>
-#                     SOURCES <file>...
-#                     )
-#      - Define swig module with given name and specified language
-#    SWIG_LINK_LIBRARIES(name [ libraries ])
-#      - Link libraries to swig module
-#
-# Source files properties on module files can be set before the invocation
-# of the SWIG_ADD_LIBRARY macro to specify special behavior of SWIG.
-#
-# The source file property CPLUSPLUS calls SWIG in c++ mode, e.g.::
-#
-#    set_property(SOURCE mymod.i PROPERTY CPLUSPLUS ON)
-#    swig_add_library(mymod LANGUAGE python SOURCES mymod.i)
-#
-# The source file property SWIG_FLAGS adds custom flags to the SWIG executable.
-#
-# The source-file property SWIG_MODULE_NAME have to be provided to specify the actual
-# import name of the module in the target language if it cannot be scanned automatically
-# from source or different from the module file basename.::
-#
-#    set_property(SOURCE mymod.i PROPERTY SWIG_MODULE_NAME mymod_realname)
-#
-# To get the name of the swig module target library, use: ${SWIG_MODULE_${name}_REAL_NAME}.
-#
-# Also some variables can be set to specify special behavior of SWIG.
-#
-# CMAKE_SWIG_FLAGS can be used to add special flags to all swig calls.
-#
-# CMAKE_SWIG_OUTDIR allows one to specify where to write
-# the language specific files (swig -outdir option).
-#
-# SWIG_OUTFILE_DIR allows one to specify where to write the output file
-# (swig -o option).  If not specified, CMAKE_SWIG_OUTDIR is used.
-#
-# The name-specific variable SWIG_MODULE_<name>_EXTRA_DEPS may be used to specify extra
-# dependencies for the generated modules.
-#
-# If the source file generated by swig need some special flag you can use::
-#
-#    set_source_files_properties( ${swig_generated_file_fullname}
-#                                 PROPERTIES COMPILE_FLAGS "-bla")
+#[=======================================================================[.rst:
+UseSWIG
+-------
+
+Defines the following macros for use with SWIG:
+
+::
+
+   SWIG_ADD_LIBRARY(<name>
+                    [TYPE <SHARED|MODULE|STATIC|USE_BUILD_SHARED_LIBS>]
+                    LANGUAGE <language>
+                    SOURCES <file>...
+                    )
+     - Define swig module with given name and specified language
+   SWIG_LINK_LIBRARIES(name [ libraries ])
+     - Link libraries to swig module
+
+Source files properties on module files can be set before the invocation
+of the SWIG_ADD_LIBRARY macro to specify special behavior of SWIG.
+
+The source file property CPLUSPLUS calls SWIG in c++ mode, e.g.::
+
+   set_property(SOURCE mymod.i PROPERTY CPLUSPLUS ON)
+   swig_add_library(mymod LANGUAGE python SOURCES mymod.i)
+
+The source file property SWIG_FLAGS adds custom flags to the SWIG executable.
+
+The source-file property SWIG_MODULE_NAME have to be provided to specify the actual
+import name of the module in the target language if it cannot be scanned automatically
+from source or different from the module file basename.::
+
+   set_property(SOURCE mymod.i PROPERTY SWIG_MODULE_NAME mymod_realname)
+
+To get the name of the swig module target library, use: ${SWIG_MODULE_${name}_REAL_NAME}.
+
+Also some variables can be set to specify special behavior of SWIG.
+
+CMAKE_SWIG_FLAGS can be used to add special flags to all swig calls.
+
+CMAKE_SWIG_OUTDIR allows one to specify where to write
+the language specific files (swig -outdir option).
+
+SWIG_OUTFILE_DIR allows one to specify where to write the output file
+(swig -o option).  If not specified, CMAKE_SWIG_OUTDIR is used.
+
+The name-specific variable SWIG_MODULE_<name>_EXTRA_DEPS may be used to specify extra
+dependencies for the generated modules.
+
+If the source file generated by swig need some special flag you can use::
+
+   set_source_files_properties( ${swig_generated_file_fullname}
+                                PROPERTIES COMPILE_FLAGS "-bla")
+#]=======================================================================]
 
 set(SWIG_CXX_EXTENSION "cxx")
 set(SWIG_EXTRA_LIBRARIES "")