Table doc strings now display reverse-engineered table declarations

Author: dimitri-yatsenko

datajoint/heading.py

@@ -247,7 +247,8 @@ def init_from_database(self, conn, database, table_name, context):
                     category = next(c for c in SPECIAL_TYPES if TYPE_PATTERN[c].match(attr['type']))
                 except StopIteration:
                     if attr['type'].startswith('external'):
-                        raise DataJointError('Legacy datatype `{type}`.'.format(**attr)) from None
+                        raise DataJointError('Legacy datatype `{type}`. '
+                                             'Migrate your external stores to datajoint 0.12'.format(**attr)) from None
                     raise DataJointError('Unknown attribute type `{type}`'.format(**attr)) from None
                 if category == 'FILEPATH' and not _support_filepath_types():
                     raise DataJointError("""

datajoint/schema.py

@@ -193,7 +193,8 @@ def process_table_class(self, table_class, context, assert_declared=False):
 
         # 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
+            table_class.__doc__ = ((table_class.__doc__ or "") + "\n\nTable definition:\n"
+                                   + table_class.describe(printout=False))
 
         # fill values in Lookup tables from their contents property
         if isinstance(instance, Lookup) and hasattr(instance, 'contents') and is_declared: