bsIO: add descriptive comments