started on the shell() function in shell and added some documentation to shell