From 9e3e6a2eeae4d8d2fd038f4ca480b832aa1cc1a5 Mon Sep 17 00:00:00 2001
From: Takafumi Arakaki <aka.tkf@gmail.com>
Date: Wed, 13 Mar 2013 20:29:02 +0100
Subject: [PATCH] Document BaseDefinition.description

---
 jedi/api_classes.py | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/jedi/api_classes.py b/jedi/api_classes.py
index 95cbdd41..7feca504 100644
--- a/jedi/api_classes.py
+++ b/jedi/api_classes.py
@@ -215,7 +215,31 @@ class BaseDefinition(object):
 
     @property
     def description(self):
-        """A textual description of the object."""
+        """
+        A textual description of the object.
+
+        Example:
+
+        >>> from jedi import Script
+        >>> source = '''
+        ... def f():
+        ...     pass
+        ...
+        ... class C:
+        ...     pass
+        ...
+        ... variable = f or C'''
+        >>> script = Script(source, len(source.splitlines()), 3, 'example.py')
+        >>> defs = script.definition()
+        >>> defs = sorted(defs, key=lambda d: d.line)
+        >>> defs
+        [<Definition def f>, <Definition class C>]
+        >>> defs[0].description
+        'def f'
+        >>> defs[1].description
+        'class C'
+
+        """
         return unicode(self.definition)
 
     @property