CMake updates

[victorapm]

• Finalized implementation of HIP support in CMake build
• Achieve feature parity between CMake and Autotools builds
• Upgrade CMake minimum required version to 3.21 (required by HIP)
• Update CMake to use modern keywords and best practices
• Better status messaging when running cmake
• Add HYPRE_SetupGPUToolkit.cmake to manage GPU options in cmake build
• Refactor top-level CMakeLists and moved helper functions to HYPRE_CMakeUtilities.cmake, e.g., setup_git_version_info for configuring and displaying hypre version using git version info
• Add SOVERSION field to CMake build
• Enable configuration of third-party libraries (TPLs) via CMake module
• Add summary table of options used to configure hypre in CMake build
• Remove HYPRE_INSTALL_PATH in favor of the commonly used CMAKE_INSTALL_PATH
• Remove HYPRE_BUILD_TYPE in favor of the commonly used CMAKE_BUILD_TYPE
• Remove HYPRE_ENABLE_SHARED in favor of the commonly used BUILD_SHARED_LIBS
• Update documentation to reflect mainly CMake changes + a few fixes
  • See https://hypre.readthedocs.io/en/cmake-hip/
• Add CMake tests to machine-tioga
• Add CTest support

Closes #1104
Closes #673
Closes #1084
Closes #1073
Closes #1072
Closes #1039
Closes #907
Closes #767
Closes #757
Closes #771
Closes #501
Closes #473
Closes #228
Closes #928

[rfalgout]

FYI, I added a read-the-docs link above in the description for this PR

[rfalgout]

Why was this removed? I think this has to do with the version check stuff.

[rfalgout]

See #472

[victorapm]

Hi Rob, I moved this check to inside the new macro:

hypre/src/config/cmake/HYPRE_CMakeUtilities.cmake

Line 32 in dd81c97

if (EXISTS "${HYPRE_GIT_DIR}")

[rfalgout]

Hi @victorapm . I upgraded my version of cmake, but when I do cmake .. in the src/cmbuild directory I get an error:

Could NOT find BLAS (missing: BLAS_LIBRARIES)

We shouldn't require the blas to build hypre. Let me know what I should do. Thanks!

[rfalgout]

BTW, I am starting to think we should remove the README.txt file from cmbuild. I often like to just remove everything and start over with a new cmake .. since hypre is so quick to compile. Also, the caching can be tricky. What do you think?

[victorapm]

We shouldn't require the blas to build hypre

Hi Rob, thanks for catching this. I fixed a typo in CMakeLists and this should work as expected now. Thanks!

I am starting to think we should remove the README.txt

I agree we should do this for the same reason you brought up