From 0bd7f6bb562ba8d7cb22d3e38af9eca98aebb7f6 Mon Sep 17 00:00:00 2001
From: stroeder <stroeder>
Date: Tue, 5 Sep 2017 07:38:45 +0000
Subject: [PATCH] more docs on SASL binds

---
 Doc/ldap-sasl.rst | 12 +++++++++++-
 Doc/ldap.rst      |  4 +++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/Doc/ldap-sasl.rst b/Doc/ldap-sasl.rst
index 6bc9afe..8436b73 100644
--- a/Doc/ldap-sasl.rst
+++ b/Doc/ldap-sasl.rst
@@ -1,4 +1,4 @@
-.. % $Id: ldap-sasl.rst,v 1.4 2017/08/01 17:48:00 stroeder Exp $
+.. % $Id: ldap-sasl.rst,v 1.5 2017/09/05 07:38:45 stroeder Exp $
 
 
 ***********************************************
@@ -38,19 +38,29 @@ Classes
 
 .. autoclass:: ldap.sasl.sasl
    :members:
+   
+   This class is used with :py:meth:`ldap.LDAPObject.sasl_interactive_bind_s()`.
+
 
 .. autoclass:: ldap.sasl.cram_md5
    :members:
 
+
 .. autoclass:: ldap.sasl.digest_md5
    :members:
 
+
 .. autoclass:: ldap.sasl.gssapi
    :members:
 
+   You might consider using convenience method :py:meth:`ldap.LDAPObject.sasl_gssapi_bind_s()`.
+
+
 .. autoclass:: ldap.sasl.external
    :members:
 
+   You might consider using convenience method :py:meth:`ldap.LDAPObject.sasl_external_bind_s()`.
+
 
 .. _ldap.sasl-example:
 
diff --git a/Doc/ldap.rst b/Doc/ldap.rst
index 10abf2a..64573d6 100644
--- a/Doc/ldap.rst
+++ b/Doc/ldap.rst
@@ -1,4 +1,4 @@
-.. % $Id: ldap.rst,v 1.41 2017/09/05 07:23:36 stroeder Exp $
+.. % $Id: ldap.rst,v 1.42 2017/09/05 07:38:46 stroeder Exp $
 
 ********************************************
 :py:mod:`ldap` LDAP library interface module
@@ -935,6 +935,8 @@ and wait for and return with the server's result, or with
 .. py:method:: LDAPObject.sasl_interactive_bind_s(who, auth[, serverctrls=None [, clientctrls=None [, sasl_flags=ldap.SASL_QUIET]]]) -> None
 
    This call is used to bind to the directory with a SASL bind request.
+   
+   *auth* is an :py:class:`ldap.sasl.sasl()` instance.
 
    *serverctrls* and *clientctrls* like described in section :ref:`ldap-controls`.