Add the missing `--mpi` flag.
Add a note about using the master version of h5py.
Add a couple of sub-headings and reword a sentence.
Merge pull request #152 from enthought/bugfix/fix-hdf5-build-notes

Fix hdf5 build notes