docced, tested flags up to including C

- separated out debug-only tests
- included comment files with source samples for most flags