shell + test
import shorthands
update docs
fix shell tests
fix doctests
Merge branch 'feature/issue-15-eg-shell' into develop