python: add docstrings to Validator and ValidationError

Signed-off-by: Rob van der Linde <rob@catalyst.net.nz>
Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>

diff --git a/python/samba/getopt.py b/python/samba/getopt.py
index 04cae4cce784521367c2b807eeb296fe39e85850..96fbace0d4121faf4a4286d9f81ee5bf1d23c579 100644 (file)
--- a/python/samba/getopt.py
+++ b/python/samba/getopt.py
@@ -76,10 +76,18 @@ def check_bytes(option, opt, value):
 
 
 class ValidationError(Exception):
+    """ValidationError is the exception raised by validators.
+
+    Should be raised from the __call__ method of the Validator subclass.
+    """
     pass
 
 
 class Validator(metaclass=ABCMeta):
+    """Base class for Validators used by SambaOption.
+
+    Subclass this to make custom validators and implement __call__.
+    """
 
     @abstractmethod
     def __call__(self, field, value):