proxy: add docstrings
Merge pull request #1612 from jonboulle/proxy

proxy: add docstrings