Deprecation warning for the CLI

keystoneclient/shell.py's docstr is rendered by argparse as the
description for:

    $ keystone --help

Change-Id: I7355cdf533800086027824fb729eb52cdd8bbc33