Long comment at top of each CMakeLists.txt in src, libraries, modules

libraries/CMakeLists.txt

+#[[
+A directory containing library targets
+]]
+
 # Include the libraries that we'll build
 
 # The list of modules is ordered so that each library occurs after any others

libraries/image-compiler/CMakeLists.txt

@@ -2,7 +2,7 @@
 A small program that is run at build time of the application.  For each built-in
 theme it generates a header file from image files.  The images are part of the
 source code tree but not deployed with the program.
-]]#
+]]
 
 if( NOT IMAGE_COMPILER_EXECUTABLE )
    add_executable( image-compiler imageCompilerMain.cpp )

libraries/lib-audio-devices/CMakeLists.txt

@@ -8,7 +8,7 @@ Also abstract class Meter for communicating buffers of samples for display
 purposes.
 
 Does not contain an audio engine.
-]]#
+]]
 
 set( SOURCES
    AudioIOBase.cpp

libraries/lib-audio-unit/CMakeLists.txt

 #[[
 AudioUnit effect processing logic, minus user interface
-]]#
+]]
 
 if (USE_AUDIO_UNITS)
 

libraries/lib-basic-ui/CMakeLists.txt

@@ -11,7 +11,7 @@ There is a global pointer to an instance of Services, and the main program is
 expected, at startup, to create a static instance of a subclass of Services and
 set the pointer.  If it does not, then calls to the non-member functions in
 namespace BasicUI are no-ops.
-]]#
+]]
 
 set( SOURCES
    BasicUI.cpp

libraries/lib-breakpad-configurer/CMakeLists.txt

-# This module provides an interface to configure and start Breakpad handler 
-# in a platform independent way.
+#[[
+This library provides an interface to configure and start Breakpad handler 
+in a platform independent way.
+]]
 
 set(SOURCES 
    BreakpadConfigurer.h

libraries/lib-crashpad-configurer/CMakeLists.txt

-# This module provides an interface to configure and start Crashpad handler 
-# in a platform independent way.
+#[[
+This library provides an interface to configure and start Crashpad handler 
+in a platform independent way.
+]]
 
 set(SOURCES 
    CrashpadConfigurer.h

libraries/lib-crypto/tests/CMakeLists.txt

+#[[
+Unit tests for lib-crypto
+]]
+
 add_unit_test(
    NAME
       lib-crypto

libraries/lib-exceptions/CMakeLists.txt

@@ -13,7 +13,7 @@ enqueues the delayed action.
 But this library does NOT define a top-level handler for the whole application,
 to catch all otherwise uncaught exceptions. That is a responsibility of high
 level code.
-]]#
+]]
 
 set( SOURCES
    AudacityException.cpp

libraries/lib-fft/CMakeLists.txt

@@ -4,7 +4,7 @@ A library for fast fourier transforms
 
 Note -- this cannot be combined with lib-math, which depends on libsoxr, which
 includes a different version of pffft.h
-]]#
+]]
 
 set( SOURCES
    FFT.cpp

libraries/lib-files/CMakeLists.txt

@@ -6,7 +6,7 @@ Also the definition of certain significant file paths, such as the directory
 for temporary projects.
 
 Also the global logger which can save to a file.
-]]#
+]]
 
 set( SOURCES
    AudacityLogger.cpp

libraries/lib-graphics/CMakeLists.txt

 #[[
 A library responsible for custom rendering in Audacity
-]]#
+]]
 
 set( SOURCES
    FrameStatistics.cpp

libraries/lib-import-export/riff-test-util/CMakeLists.txt

+#[[
+A command line testing program for tempo metadata in files
+]]
+
 add_executable(riff-test-util
    RiffTestUtil.cpp
 )

libraries/lib-import-export/tests/CMakeLists.txt

+#[[
+Unit tests for lib-import-export
+]]
+
 add_unit_test(
    NAME
       lib-import-export

libraries/lib-math/CMakeLists.txt

 #[[
 A library of mathematical utilities and manipulation of samples
-]]#
+]]
 
 addlib( libsoxr            soxr        SOXR        YES   YES   "soxr >= 0.1.1" )
 

libraries/lib-math/tests/CMakeLists.txt

+#[[
+Unit tests for lib-math
+]]
+
 add_unit_test(
    NAME
       lib-math

libraries/lib-module-manager/CMakeLists.txt

@@ -5,6 +5,7 @@ effect, generator, and analyzer plug-ins.
 Maintains persistent data in the configuration file for enablement of modules
 and plug-ins, and preferred settings.
 ]]
+
 set( SOURCES
    AsyncPluginValidator.cpp
    AsyncPluginValidator.h

libraries/lib-music-information-retrieval/tests/CMakeLists.txt

+#[[
+Unit tests for lib-music-information-retrieval
+]]
+
 add_compile_definitions(
    CMAKE_CURRENT_SOURCE_DIR="${CMAKE_CURRENT_SOURCE_DIR}"
 )

libraries/lib-network-manager/CMakeLists.txt

+#[[
+Asynchronously send and receive requests and responses over internet
+]]
+
 set(TARGET lib-network-manager)
 set( TARGET_ROOT ${CMAKE_CURRENT_SOURCE_DIR} )
 

libraries/lib-numeric-formats/tests/CMakeLists.txt

 #  SPDX-License-Identifier: GPL-2.0-or-later
+#[[
+Unit tests for lib-numeric-formats
+]]
 
 add_unit_test(
    NAME