Migrate ideas from bam2fq from htslib and document

Migrate the ideas and some of the implementaion of bam2fq over from the htslib version.
Document bam2fq and ensure it is visible on samtools usage list.