Better mention that python-dev package should be pre-installed before setting up the clients.

[wangrich]

It didn't mention that python-dev should be installed as a requirement. The result is that user will find some C files cannot be compiled which refers 'Python.h'.

Though it can be easily solved by google-ing, I hope this document could be more completed and helpful.
-----------------------------------
Built: 2014-09-08T19:51:42 00:00
git SHA: 89c00fbd6fc45ee64da4abedaf941b2bdbf2c019
URL: http://docs.openstack.org/icehouse/install-guide/install/apt/content/install_clients.html
source File: file:/home/jenkins/workspace/openstack-manuals-tox-doc-publishdocs/doc/common/section_cli_install.xml
xml:id: install_clients

[Andreas Jaeger (jaegerandi)]

Why is python-dev needed as requirement?

[wangrich (wangxiayang-fdt)]

Sorry, I should have mentioned that in details. As a user I installed the command-line client(as this document instructed. I installed multiple clients. So I cannot recall the exact one - might by nova-client because it's mentioned first in the document). The last few lines of the installation printed were the compiling failure message, indicating "Python.h" could not be found. I'd searched in the Internet and someone suggested that I should have installed python-dev package.

That's it. Sorry for the imcompleteness. I have no knowledge about how the nova system works so I cannot deliver the exact reason why some C files will be compiled in that installation. Thanks for your attention and help.

[Andreas Jaeger (jaegerandi)]

So, you installed using pip - ok.

[OpenStack Infra (hudson-openstack)]

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

commit d38b28e1f22c00e10b3e640b1eca0c38e45a0be1
Author: Steven Deaton <email address hidden>
Date: Wed Sep 10 06:56:49 2014 -0500

    Add explanation for installing Python development packages.

    Installing software via pip requires the development files
    as well. This update simply notes the package names per type
    of package being used. Also added a note about extra packages
    being possibly needed for building, such as with Tempest.

    Partial-Bug: 1367526
    Change-Id: I0430c08686012b31073ed98040b5e261a9205ca6