ironic.common.states doc out of date and partially missing

[aeva black]

ironic/common/states.py is referenced in the online developer documentation, but none of the module constants show up because they lack inline python doc strings.

http://docs.openstack.org/developer/ironic/api/ironic.common.states.html

Furthermore, the module doc header is no longer accurate and should be updated based on current behavior.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/118467
Committed: https://git.openstack.org/cgit/openstack/ironic/commit/?id=5f670651934ded2af3556b4deb8826ec89216b16
Submitter: Jenkins
Branch: master

commit 5f670651934ded2af3556b4deb8826ec89216b16
Author: David Shrewsbury <email address hidden>
Date: Tue Sep 2 17:04:06 2014 -0400

    Update ironic states and documentation

    This adds doc strings for the various states, and updates the documentation
    header to reflect the current state of states.

    In addition, this removes the following unused states:
      - INIT
      - BUILDING
      - SUSPEND

    Change-Id: Id7493e856504f5ccf67fe7a716d748ffa7248590
    Closes-Bug: #1308207