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

Includes tests and documentation.