Added doc, fix inconsistencies in preparation for Shell Reference documentation