fix #699 -- add table definition to doc string

Author: dimitri-yatsenko

datajoint/schema.py

@@ -191,6 +191,10 @@ def process_table_class(self, table_class, context, assert_declared=False):
                 instance.declare(context)
         is_declared = is_declared or instance.is_declared
 
+        # add table definition to the doc string
+        if isinstance(table_class.definition, str):
+            table_class.__doc__ = (table_class.__doc__ or "") + "\n\nTable definition:\n\n" + table_class.definition
+
         # fill values in Lookup tables from their contents property
         if isinstance(instance, Lookup) and hasattr(instance, 'contents') and is_declared:
             contents = list(instance.contents)