added examples in docstring and CL help
added shebang and executable rights