fix client docstring

* fix broken docstring in ceilometerclient.client
* remove non-existent `release` index
* remove duplicated reference generation in ext/gen_ref.py

Change-Id: Iad8c527e61628a406d5dd84adac875190b994fac
Closes-Bug: #1440629

ceilometerclient/client.py

@@ -282,7 +282,9 @@ def get_client(version, **kwargs):
             * ceilometer_url: (DEPRECATED) Ceilometer API endpoint,
                               use os_endpoint instead
             * os_endpoint: Ceilometer API endpoint
+
             or:
+
             * os_username: name of user
             * os_password: user's password
             * os_user_id: user's id

doc/ext/gen_ref.py

@@ -52,8 +52,3 @@ def gen_ref(ver, title, names):
                           % {"title": name.capitalize(),
                              "signs": "=" * len(name),
                              "pkg": pkg, "name": name})
-
-gen_ref("", "Client Reference", ["client", "exc"])
-gen_ref("v1", "Version 1 API Reference",
-        ["stacks", "resources", "events", "actions",
-         "software_configs", "software_deployments"])

doc/source/index.rst

@@ -24,7 +24,6 @@ Contents:
    ref/index
    ref/v1/index
    ref/v2/index
-   releases
 
 Contributing
 ============