Update comment documentation for bam_mate

Clarify how we now handle supplementary reads and note limitation.