hdf5doc

Made an edit pass and tried to address open questions in the previous version.   

Cut some text from the previous version that may be relevant in the future
when there are more than 2 version-numbered functions per macro.  May want to
revisit when that happens.

 --This line, and those below, will be ignored--

M    APICompatMacros.html