summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/ext/declarative/api.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/sqlalchemy/ext/declarative/api.py')
-rw-r--r--lib/sqlalchemy/ext/declarative/api.py6
1 files changed, 6 insertions, 0 deletions
diff --git a/lib/sqlalchemy/ext/declarative/api.py b/lib/sqlalchemy/ext/declarative/api.py
index e67e79d55..1abd0467e 100644
--- a/lib/sqlalchemy/ext/declarative/api.py
+++ b/lib/sqlalchemy/ext/declarative/api.py
@@ -301,6 +301,9 @@ def declarative_base(bind=None, metadata=None, mapper=None, cls=object,
compatible callable to use as the meta type of the generated
declarative base class.
+ .. versionchanged:: 1.1 if :paramref:`.declarative_base.cls` is a single class (rather
+ than a tuple), the constructed base class will inherit its docstring.
+
.. seealso::
:func:`.as_declarative`
@@ -317,6 +320,9 @@ def declarative_base(bind=None, metadata=None, mapper=None, cls=object,
class_dict = dict(_decl_class_registry=class_registry,
metadata=lcl_metadata)
+ if isinstance(cls, type):
+ class_dict['__doc__'] = cls.__doc__
+
if constructor:
class_dict['__init__'] = constructor
if mapper: