Comment 3 for bug 530634

I am working on this for the same reason as OP: pygpgme seems the only decent way to use GPG from Python, but the lack of documentation is frustrating.

I started adding docstrings as well (and temporarily put code on https://github.com/rshk/pygpgme/ as I have no clue on how to use bazaar) as the initial idea was to generate documentation with Sphinx's autodoc, but apparently something didn't work and documentation doesn't get extracted properly.

At the end, I decided to write "plain" documentation using Sphinx (which, while requiring docs and code to stay in two different places, allows for a more "descriptive" documentation, documenting constants / attributes, etc.).

It is still work in progress, but you can find the current version here: http://pygpgme.readthedocs.org/en/latest/

Help is very welcome (and I'm going to send a pull request here once I look up how to do that).