For a new FAQ:
Q: I get errors like "/usr/include/H5Dpublic.h:145: error: too many arguments to function ‘hid_t H5Dopen1(hid_t, const char*)’"
A: The HDF5 library you use is either version 1.6 or defaults to it. If it is version 1.6.x, update to 1.8.x. If it is 1.8.x and it defaults to the 1.6 API version, you might be out of luck, especially on Debian Squeeze systems, see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537414. What you can then do is to remove (comment) out the macro H5_USE_16_API_DEFAULT in /usr/include/H5pubconf.h. This isn't pretty, but is really a bug in the package and has to be fixed there. There is no way to switch to the new API on those systems, other than specifying the API version of each symbol separately, which would be even messier.