[DOC] Various improvements to API dox.

`BgfzFile` must be `BamFileIn`