Merge topic 'discourage-cmake_install'

0f76839bc7 Help: Discourage direct use of cmake_install.cmake

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !4553
diff --git a/Help/command/install.rst b/Help/command/install.rst
index cf04eda..3b72ea6 100644
--- a/Help/command/install.rst
+++ b/Help/command/install.rst
@@ -705,6 +705,11 @@
 Generated Installation Script
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+.. note::
+
+  Use of this feature is not recommended. Please consider using the
+  ``--install`` argument of :manual:`cmake(1)` instead.
+
 The ``install()`` command generates a file, ``cmake_install.cmake``, inside
 the build directory, which is used internally by the generated install target
 and by CPack. You can also invoke this script manually with ``cmake -P``. This