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