Merge topic 'doc-multiple-src-paths'

1b8669c1d6 Help: Document warning about multiple source paths

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7082

Help/manual/cmake.1.rst

@@ -171,6 +171,13 @@ is used for the other.  For example:
  ``cmake -B build -S src``      ``src``      ``build``
 ============================== ============ ===========
 
+.. versionchanged:: 3.23
+
+  CMake warns when multiple source paths are specified.  This has never
+  been officially documented or supported, but older versions accidentally
+  accepted multiple source paths and used the last path specified.
+  Avoid passing multiple source path arguments.
+
 After generating a buildsystem one may use the corresponding native
 build tool to build the project.  For example, after using the
 :generator:`Unix Makefiles` generator one may run ``make`` directly:

Help/release/3.23.rst

@@ -225,6 +225,12 @@ CPack
 Deprecated and Removed Features
 ===============================
 
+* :manual:`cmake(1)` now warns when multiple source paths are specified,
+  as in ``cmake -S src1 src2``.  This has never been officially documented
+  or supported, but older versions accidentally accepted multiple source
+  paths and used the last path specified.  Update scripts to avoid
+  passing multiple source path arguments.
+
 * The :manual:`cpack(1)` undocumented ``OSXX11`` generator has been removed.
 
 Other Changes