add shell usage example to docstring