Improve documentation

This patch:

* exposes eventlet.greenthread.kill function so Sphinx generates
  its documentation and fixes broken links to :func:`kill`
* adds warning about wsgi.server waiting for active connections to
  finish before returning

@temoto please QA, I think it's useful to have this information in the documentation, today I witnessed this behaviour causing a lot of confusion.