skip include directives when processing comment blocks

additionally:

- add tests for skipping include directives in comment blocks
- document exceptions in test cases
- drop unnecessary method aliases