minor corrections to documentation
add a few comments
add some file-checking macros
change 'id' to 'file_id' to differentiate from other ids
change hdf5 check to a more generic function
change some definition names, small doc fixes
verify that input hdf5 file has expected format
add some files to dist and build that caused 'make distcheck' to fail