cxxmodules: Reference documentation in no-modules-support diagnostics

Help users avoid errors about module support when they may not need it.

While at it, polish sentence syntax in the diagnostic messages.

6 files changed, 34 insertions, 24 deletions

diff --git a/Tests/RunCMake/CXXModules/CMP0155-NEW-stderr.txt b/Tests/RunCMake/CXXModules/CMP0155-NEW-stderr.txt
index d103201..0843d0b 100644
--- a/Tests/RunCMake/CXXModules/CMP0155-NEW-stderr.txt
+++ b/Tests/RunCMake/CXXModules/CMP0155-NEW-stderr.txt
@@ -1,7 +1,10 @@
 (CMake Error in CMakeLists.txt:
-  The target named "cmp0155-new" has C\+\+ sources that use modules but the
-  compiler does not provide a way to discover the import graph dependencies
+  The target named "cmp0155-new" has C\+\+ sources that may use modules, but
+  the compiler does not provide a way to discover the import graph
+  dependencies\.  See the cmake-cxxmodules\(7\) manual and the
+  CMAKE_CXX_SCAN_FOR_MODULES variable\.
 |CMake Error in CMakeLists.txt:
-  The target named "cmp0155-new" contains C\+\+ sources that use modules which
-  is not supported by the generator
+  The target named "cmp0155-new" has C\+\+ sources that may use modules, but
+  modules are not supported by this generator\.  See the cmake-cxxmodules\(7\)
+  manual and the CMAKE_CXX_SCAN_FOR_MODULES variable\.
 )
diff --git a/Tests/RunCMake/CXXModules/NoCXX-stderr.txt b/Tests/RunCMake/CXXModules/NoCXX-stderr.txt
index accc622..ba2715b 100644
--- a/Tests/RunCMake/CXXModules/NoCXX-stderr.txt
+++ b/Tests/RunCMake/CXXModules/NoCXX-stderr.txt
@@ -1,9 +1,10 @@
 (CMake Error in CMakeLists.txt:
-  The target named "nocxx" has C\+\+ sources that use modules but the "CXX"
-  language has not been enabled
+  The target named "nocxx" has C\+\+ sources that use modules, but the "CXX"
+  language has not been enabled\.
 |CMake Error in CMakeLists.txt:
-  The target named "nocxx" contains C\+\+ sources that use modules which is not
-  supported by the generator
+  The target named "nocxx" has C\+\+ sources that may use modules, but modules
+  are not supported by this generator\.  See the cmake-cxxmodules\(7\) manual
+  and the CMAKE_CXX_SCAN_FOR_MODULES variable\.
 |CMake Error in CMakeLists.txt:
   Target "nocxx" has source file
 
diff --git a/Tests/RunCMake/CXXModules/NoCXX20-stderr.txt b/Tests/RunCMake/CXXModules/NoCXX20-stderr.txt
index c83e26d..3f3a547 100644
--- a/Tests/RunCMake/CXXModules/NoCXX20-stderr.txt
+++ b/Tests/RunCMake/CXXModules/NoCXX20-stderr.txt
@@ -1,8 +1,9 @@
 (CMake Error in CMakeLists.txt:
-  The target named "nocxx20" has C\+\+ sources that use modules but does not
+  The target named "nocxx20" has C\+\+ sources that use modules, but does not
   include "cxx_std_20" \(or newer\) among its `target_compile_features`; found
-  "cxx_std_17"
+  "cxx_std_17"\.
 |CMake Error in CMakeLists.txt:
-  The target named "nocxx20" contains C\+\+ sources that use modules which is
-  not supported by the generator
+  The target named "nocxx20" has C\+\+ sources that may use modules, but
+  modules are not supported by this generator\.  See the cmake-cxxmodules\(7\)
+  manual and the CMAKE_CXX_SCAN_FOR_MODULES variable\.
 )
diff --git a/Tests/RunCMake/CXXModules/NoDyndepSupport-stderr.txt b/Tests/RunCMake/CXXModules/NoDyndepSupport-stderr.txt
index 0ba2dde..c7e2979 100644
--- a/Tests/RunCMake/CXXModules/NoDyndepSupport-stderr.txt
+++ b/Tests/RunCMake/CXXModules/NoDyndepSupport-stderr.txt
@@ -6,6 +6,7 @@
 
   due to lack of required features\.  Ninja 1\.11 or higher is required\.
 |CMake Error in CMakeLists.txt:
-  The target named "nodyndep" contains C\+\+ sources that use modules which is
-  not supported by the generator
+  The target named "nodyndep" has C\+\+ sources that may use modules, but
+  modules are not supported by this generator\.  See the cmake-cxxmodules\(7\)
+  manual and the CMAKE_CXX_SCAN_FOR_MODULES variable\.
 )
diff --git a/Tests/RunCMake/CXXModules/NoScanningSourceFileProperty-stderr.txt b/Tests/RunCMake/CXXModules/NoScanningSourceFileProperty-stderr.txt
index d3edb21..ed78672 100644
--- a/Tests/RunCMake/CXXModules/NoScanningSourceFileProperty-stderr.txt
+++ b/Tests/RunCMake/CXXModules/NoScanningSourceFileProperty-stderr.txt
@@ -1,8 +1,10 @@
 (CMake Error in CMakeLists.txt:
-  The target named "noscanning-sf-property" has C\+\+ sources that use modules
-  but the compiler does not provide a way to discover the import graph
-  dependencies
+  The target named "noscanning-sf-property" has C\+\+ sources that may use
+  modules, but the compiler does not provide a way to discover the import
+  graph dependencies\.  See the cmake-cxxmodules\(7\) manual and the
+  CMAKE_CXX_SCAN_FOR_MODULES variable\.
 |CMake Error in CMakeLists.txt:
-  The target named "noscanning-sf-property" contains C\+\+ sources that use
-  modules which is not supported by the generator
+  The target named "noscanning-sf-property" has C\+\+ sources that may use
+  modules, but modules are not supported by this generator\.  See the
+  cmake-cxxmodules\(7\) manual and the CMAKE_CXX_SCAN_FOR_MODULES variable\.
 )
diff --git a/Tests/RunCMake/CXXModules/NoScanningTargetProperty-stderr.txt b/Tests/RunCMake/CXXModules/NoScanningTargetProperty-stderr.txt
index a18b98b..9dfb3e9 100644
--- a/Tests/RunCMake/CXXModules/NoScanningTargetProperty-stderr.txt
+++ b/Tests/RunCMake/CXXModules/NoScanningTargetProperty-stderr.txt
@@ -1,8 +1,10 @@
 (CMake Error in CMakeLists.txt:
-  The target named "noscanning-target-property" has C\+\+ sources that use
-  modules but the compiler does not provide a way to discover the import
-  graph dependencies
+  The target named "noscanning-target-property" has C\+\+ sources that may use
+  modules, but the compiler does not provide a way to discover the import
+  graph dependencies\.  See the cmake-cxxmodules\(7\) manual and the
+  CMAKE_CXX_SCAN_FOR_MODULES variable\.
 |CMake Error in CMakeLists.txt:
-  The target named "noscanning-target-property" contains C\+\+ sources that use
-  modules which is not supported by the generator
+  The target named "noscanning-target-property" has C\+\+ sources that may use
+  modules, but modules are not supported by this generator\.  See the
+  cmake-cxxmodules\(7\) manual and the CMAKE_CXX_SCAN_FOR_MODULES variable\.
 )