Migrate ideas from bam2fq from htslib and document

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

Signed-off-by: Martin O. Pollard <mp15@sanger.ac.uk>