document options
document events
fake the shell part for more portable tests
1.0.1