[MacPorts] #67636: hdf5 @1.14: configured to expose v1.10 API

[MacPorts]

#67636: hdf5 @1.14: configured to expose v1.10 API
-----------------------+----------------------
  Reporter:  rmclaren  |      Owner:  eborisch
      Type:  defect    |     Status:  assigned
  Priority:  Normal    |  Milestone:
 Component:  ports     |    Version:
Resolution:            |   Keywords:
      Port:  hdf5      |
-----------------------+----------------------

Comment (by Dave-Allured):

 > It’s always hard to say what’s the best approach ...

 In my opinion, **best practice** for HDF5 with its frequent API changes is
 simple.  Whenever updating HDF5, never add --with-default-api-version.
 **Always keep the default API** for the new version being installed.

 Therefore, please remove **--with-default-api-version=v110** from HDF5
 portfile, as suggested by the reporter.

 Some dependent ports use only **stable** HDF5 functions and will not need
 adjustment.  Those that use **version-dependent** HDF5 functions should
 declare their version dependency with **-DH5_USE_XXX_API** at the source.
 If source does not declare, then add -DH5_USE_XXX_API in Portfile and/or
 through patches, as appropriate.

 The HDF5 library was intentionally designed to work this way.  It presents
 multiple API versions in a single library build.  However, dependent ports
 or "applications" must use the intended compatibility controls unless they
 are upgraded to the most recent API version.
 https://portal.hdfgroup.org/display/HDF5/API+Compatibility+Macros

 This recommended change will require that all direct dependent ports be
 checked for breakage.  Ports with version dependency that do not already
 use -DH5_USE_XXX_API somewhere, should be fixed as described above.

-- 
Ticket URL: <https://trac.macports.org/ticket/67636#comment:4>
MacPorts <https://www.macports.org/>
Ports system for macOS