CMake: AMReX_INSTALL (AMReX-Codes#1831)

Add an `AMReX_INSTALL` option that controls `install()` generation.

Such options are typically used in superbuilds by dependent projects
to supress the install of AMReX headers, helpers and libs, e.g. if
AMReX is fully consumed as private dependency.

CMakeLists.txt

@@ -143,8 +143,11 @@ endif ()
 #
 # Install amrex  -- Export
 #
-include(AMReXInstallHelpers)
-install_amrex_targets(${_amrex_targets})
+option(AMReX_INSTALL "Generate Install Targets" YES)
+if(AMReX_INSTALL)
+    include(AMReXInstallHelpers)
+    install_amrex_targets(${_amrex_targets})
+endif()
 
 
 #

Docs/sphinx_documentation/source/BuildingAMReX.rst

@@ -491,6 +491,8 @@ The list of available options is reported in the :ref:`table <tab:cmakevar>` bel
    +------------------------------+-------------------------------------------------+-------------------------+-----------------------+
    | AMReX_DIFFERENT_COMPILER     |  Allow an app to use a different compiler       | NO                      | YES, NO               |
    +------------------------------+-------------------------------------------------+-------------------------+-----------------------+
+   | AMReX_INSTALL                |  Generate Install Targets                       | YES                     | YES, NO               |
+   +------------------------------+-------------------------------------------------+-------------------------+-----------------------+
 .. raw:: latex
 
    \end{center}