dev docs and API examples are wrong

[John Griffith]

The docs in python-cinderclient have never been maintained properly and are completely inaccurate. We need to clean this up for the next push to PyPi, add some real examples, fix the README and add change info.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/24757

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/24757
Committed: http://github.com/openstack/python-cinderclient/commit/020778ddd942e762a5e543e41bc3f4d95df3b91e
Submitter: Jenkins
Branch: master

commit 020778ddd942e762a5e543e41bc3f4d95df3b91e
Author: john-griffith <email address hidden>
Date: Tue Mar 19 00:24:32 2013 -0600

    Docs in cinderlcient were never actually updated.

    Not only were the docs and release info here not being
    maintainted properly, but the examples that were given were
    not correct.

    This change is an attempt to set us on the right path going
    forward and includes info on how to import the API and history
    info for the upcoming release/push to PyPi.

    Fixes bug: 1156994

    Change-Id: I169b1c01380ef653a6a25eb8946b9a06d6419e62