diff options
Diffstat (limited to 'lib/sqlalchemy/ext/mutable.py')
| -rw-r--r-- | lib/sqlalchemy/ext/mutable.py | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/lib/sqlalchemy/ext/mutable.py b/lib/sqlalchemy/ext/mutable.py index ece7e3ad4..8f14f5197 100644 --- a/lib/sqlalchemy/ext/mutable.py +++ b/lib/sqlalchemy/ext/mutable.py @@ -448,7 +448,9 @@ class Mutable(MutableBase): This is a convenience method that calls ``associate_with_attribute`` automatically. - .. warning:: The listeners established by this method are *global* + .. warning:: + + The listeners established by this method are *global* to all mappers, and are *not* garbage collected. Only use :meth:`.associate_with` for types that are permanent to an application, not with ad-hoc types else this will cause unbounded growth @@ -488,7 +490,9 @@ class Mutable(MutableBase): of the particular :meth:`.Mutable` subclass to establish a global association. - .. warning:: The listeners established by this method are *global* + .. warning:: + + The listeners established by this method are *global* to all mappers, and are *not* garbage collected. Only use :meth:`.as_mutable` for types that are permanent to an application, not with ad-hoc types else this will cause unbounded growth @@ -519,7 +523,9 @@ class MutableComposite(MutableBase): See the example in :ref:`mutable_composites` for usage information. - .. warning:: The listeners established by the :class:`.MutableComposite` + .. warning:: + + The listeners established by the :class:`.MutableComposite` class are *global* to all mappers, and are *not* garbage collected. Only use :class:`.MutableComposite` for types that are permanent to an application, not with ad-hoc types else this will cause unbounded growth |