updating shell mode - lots has been removed

but enough is still there to keep this documentation around