[FEATURE] Adding support for "supplementary" flag for BAM I/O.

Includes tests and documentation.
Merge pull request #466 from holtgrewe/hotfix/bam_supplementary_flag

[FEATURE] Adding support for "supplementary" flag for BAM I/O (master).