CLI commands docs: Fix formatting in autogenerate tool

[Diane Fleming]

openstack/openstack-doc-tools/commands.py

Fix commands.py to provide better formatting for the auto-generated command reference.

I've emailed Andreas with suggested formatting changes.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/70328
Committed: https://git.openstack.org/cgit/openstack/openstack-doc-tools/commit/?id=0863f76f20856e459715c6084691ceb21a640e9c
Submitter: Jenkins
Branch: master

commit 0863f76f20856e459715c6084691ceb21a640e9c
Author: Andreas Jaeger <email address hidden>
Date: Thu Jan 30 22:05:15 2014 +0100

    Improve docbook format for cli commands

    Thanks to Diane for a great proposal!

    Also fixes autogenerate_config_docs/common.py to pass pep8 check.

    Closes-Bug: #1274699
    Change-Id: Ic7b9cacc99a8bdf39c7a0f7e429d9f538370f048

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/70326
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=5c6e2c94d20a435e60bbb6ed59d8f2207cc311a3
Submitter: Jenkins
Branch: master

commit 5c6e2c94d20a435e60bbb6ed59d8f2207cc311a3
Author: Andreas Jaeger <email address hidden>
Date: Fri Jan 31 12:06:29 2014 +0100

    Update generated cli commands

    Update with new openstack-auto-commands tool.

    Partial-Bug: #1274699
    Change-Id: Id3fee3024fca9fc09009969ffc58c74934a56a7f