documentation updates

[Michael Ströder]

James,

first of all many thanks for your efforts working on this.

James Andrewartha wrote:
> 
> Is there anything else I need to do to get these applied, and the
> version of the docs on the website updated?

I've started reviewing your patches this morning and I have some doubts
about some details which need clarification. This will take a little
bit. I will follow-up on this when I have some spare time left. Maybe
tomorrow...

One general note: I didn't document some stuff since I didn't want to
endorse it because I don't consider certain APIs to be really stable
(say: designed well). Examples are class SmartLDAPObject, the API of
ldap.schema etc.

So take a break until I follow-up on this. Thanks again.

Ciao, Michael.