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

libraries/lib-uuid/CMakeLists.txt

+#[[
+Generation of UUIDs
+]]
+
 set( TARGET lib-uuid )
 set( TARGET_ROOT ${CMAKE_CURRENT_SOURCE_DIR} )
 

libraries/lib-viewport/CMakeLists.txt

@@ -2,6 +2,7 @@
 Viewport defines a callback facade for horizontal and vertical scrollbars, and
 provides methods to scroll and zoom the view of tracks.
 ]]
+
 set( SOURCES
    Viewport.cpp
    Viewport.h

libraries/lib-vst/CMakeLists.txt

 #[[
 VST 2 effect plugin discovery and processing logic, without user interface
-]]#
+]]
 
 set( SOURCES
    VSTEffectBase.cpp

libraries/lib-wx-init/CMakeLists.txt

 #[[
 Startup time injections of wxWidgets based implementations of services behind
 toolkit-neutral facades
-]]#
+]]
 
 set( SOURCES
    AccessibleLinksFormatter.cpp

libraries/lib-xml/CMakeLists.txt

@@ -3,7 +3,7 @@ Utilities to serialize and deserialize trees of objects in XML form, and a
 class template XMLMethodRegistry to generate registries for serializable
 objects attached to a host object.  The template is parametrized by the host
 type.
-]]#
+]]
 
 set( SOURCES
    XMLAttributeValueView.cpp

modules/CMakeLists.txt

+#[[
+A directory of directories of module targets.  Sub-directories group modules in
+some common area of functionality, such as import/export, and each group becomes
+a cluster in the modules.dot file generated at configuration time.
+]]
+
 # Include the modules that we'll build
 
 # The list of module sub-folders is ordered so that each folder occurs after any

modules/etc/CMakeLists.txt

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

modules/etc/mod-null/CMakeLists.txt

+#[[
+A skeletal example module that does nothing
+]]
+
 set( TARGET mod-null )
 set( DEFINES
    PRIVATE

modules/import-export/CMakeLists.txt

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

modules/import-export/mod-aup/CMakeLists.txt

+#[[
+Import of older Audacity project files, in .aup format, saved before version 3.0
+]]
+
 set( TARGET mod-aup )
 
 set( SOURCES

modules/import-export/mod-cl/CMakeLists.txt

+#[[
+Export of files with a command passed to a command-line shell
+]]
+
 set( TARGET mod-cl )
 
 set( SOURCES

modules/import-export/mod-ffmpeg/CMakeLists.txt

+#[[
+FFmpeg import and export
+]]
+
 set( TARGET mod-ffmpeg )
 
 add_subdirectory(lib-ffmpeg-support)

modules/import-export/mod-ffmpeg/lib-ffmpeg-support/CMakeLists.txt

+#[[
+Various versions of FFmpeg and a facade to hide their binary incompatibilities
+]]
 
 if (${_OPT}use_ffmpeg)
    set( SOURCES

modules/import-export/mod-flac/CMakeLists.txt

+#[[
+FLAC import and export
+]]
+
 set( TARGET mod-flac )
 
 set( SOURCES

modules/import-export/mod-lof/CMakeLists.txt

+#[[
+Interpret .lof (list-of-files) format, a simple language that can name other
+files to import and then time-shift
+]]
+
 set( TARGET mod-lof )
 
 set( SOURCES

modules/import-export/mod-mp2/CMakeLists.txt

+#[[
+MP2 export
+]]
+
 set( TARGET mod-mp2 )
 
 set( SOURCES

modules/import-export/mod-mp3/CMakeLists.txt

+#[[
+MP3 export using the LAME library
+]]
+
 set( TARGET mod-mp3 )
 
 set( SOURCES

modules/import-export/mod-mpg123/CMakeLists.txt

+#[[
+MPG123 import
+]]
+
 set( TARGET mod-mpg123 )
 
 set( SOURCES

modules/import-export/mod-ogg/CMakeLists.txt

+#[[
+OGG import and export
+]]
+
 set( TARGET mod-ogg )
 
 set( SOURCES

modules/import-export/mod-opus/CMakeLists.txt

+#[[
+Opus import and export
+]]
+
 set( TARGET mod-opus )
 
 set( SOURCES