fix @Alexey-T's concern of deprecated documentation, see #317
exclude deprecated members from documentation (there are just too many), this can be undone once we've removed the old API (also cleaned up docs/conf.py a little bit). fixes #317