The documentation gate job wrongly reports success

[Ildiko Vancsa]

The docs gate job that is run for Ceilometer testing reports success in case pf malformed table error in the doc build. Sphinx fails, when the table formatting in the .rst files contains errors, like the column size isn't defined correctly. When a malformed error is reported during the documentation build it results in that the generated doc will not containe the misformatted table. The gate job should fail, if any errors are reported during the documentation build.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/96258
Committed: https://git.openstack.org/cgit/openstack/ceilometer/commit/?id=b436ddad476f7dfb6cfc435072f935247a7c0ee7
Submitter: Jenkins
Branch: master

commit b436ddad476f7dfb6cfc435072f935247a7c0ee7
Author: Ildiko Vancsa <email address hidden>
Date: Wed May 28 19:57:19 2014 +0200

    Fix doc gate job false success

    pbr config was missing from setup.cfg. With adding "warnerrors = true"
    under '[pbr]' in setup.cfg, the Sphinx build will fail in case of
    warnings and errors during the build process.

    This patch also fixes the currently existing problems in the developer
    documentation of Ceilometer. The unused todo extension was also removed.

    Fixes-Bug: #1317648
    Fixes-Bug: #1321193
    Fixes-Bug: #1272845

    Change-Id: If1a9d7aca5c1d350568a83fb49bb8ea3defefdca