Align CMake compiler wrappers with old Autotools versions

[jhendersonHDF]

Implemented missing --help/-h, -c, -echo and -shlib/-noshlib options

Added new -nohl option to avoid building and linking against high-level HDF5 libraries if desired

Implemented adding of HDF5 installation library directory to rpath of resulting executable/library and added new -norpath option to avoid this behavior if desired

Added parsing of HDF5_USE_SHLIB environment variable to determine whether to link against shared or static HDF5 libraries

Added parsing of HDF5_PKG_CONFIG_ARGS environment variable to separate pkg-config-specific options from compiler-specific options and prevent conflicts

Fixed several issues in pkg-config files generated by CMake

Fixes #4582

---

Important

Aligns CMake compiler wrappers with Autotools by adding missing options, rpath handling, and fixing pkg-config issues.

• Behavior:
  • Implemented --help/-h, -c, -echo, -shlib/-noshlib options in CMake compiler wrappers.
  • Added HDF5 library directory to rpath by default; -norpath option to disable.
  • Parses HDF5_USE_SHLIB to decide between shared/static libraries.
  • Parses HDF5_PKG_CONFIG_ARGS to separate pkg-config and compiler options.
• Pkg-config:
  • Fixed issues in pkg-config files generated by CMake.
• Scripts:
  • Changed mkdir to mkdir -p in test-pc.sh scripts across multiple directories.

^{This description was created by for 9387696. You can customize this summary. It will automatically update as commits are pushed.}

[jhendersonHDF]

Re: #4582 -

• -help, --help, -h)
  - Added both other forms

• -c)
  - Brought over the same behavior as Autotools for compatibility. Combined
  with -show, just shows the compile options without linking options.
  Without -show, just passes -c on to compiler, though this could be
  problematic for some compilers.

• -o)
  - Just passed through to compiler

• -E|-M|-MT)
  - Will be passed through directly to compiler instead
  of being an h5cc-specific option.

• -l*)
  - Will be passed through directly to compiler instead
  of being an h5cc-specific option. Some logic in Autotools
  scripts to redirect to right name when -lhdf5 is specified
  but static builds are used, but this should generally be
  able to be covered by pkg-config + compiler.

• -prefix=*)
  - Dropped as it doesn't appear to have done
  anything previously; the internal variable
  wasn't used. Can be added back in the future
  if needed, but should generally be covered
  by pkg-config except for odd cases.

• -echo)
  - Newly brought over

• -show)
  - Already implemented

• -showconfig)
  - Already implemented

• -shlib)
  - Newly brought over

• -noshlib)
  - Newly brought over

• -nohl)
  - New option

• -norpath)
  - New option

[brtnfld]

LGTM

[mattjala]

Nitpick: if not requested not to -> unless requested not to is a more clear phrasing