Add note about C extensions

There was some confusion regarding the output of easy_install pyramid
when the Python header files were not installed, these errors are
harmless however adding a simple note would have stopped a lot of
frustration.

---

This pull request is mainly to update #1128 and hopefully close that.