Migrate documentation from samtools bam.h to sam.h and add a few more items

(Cherry-picked from PR #31.)