summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/ext/mutable.py
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2011-12-25 17:34:24 -0500
committerMike Bayer <mike_mp@zzzcomputing.com>2011-12-25 17:34:24 -0500
commit68f6951019dce746a0d093ee597e89d68f4d8fc0 (patch)
tree24c6c415aacf75e2a24215626215f7853e0b9469 /lib/sqlalchemy/ext/mutable.py
parent6ed0d7e3339dd14daad612f9ac6dd2f5e90ef517 (diff)
downloadsqlalchemy-68f6951019dce746a0d093ee597e89d68f4d8fc0.tar.gz
fix a whole bunch of note:: / warning:: that were inline,
no longer compatible with docutils 0.8
Diffstat (limited to 'lib/sqlalchemy/ext/mutable.py')
-rw-r--r--lib/sqlalchemy/ext/mutable.py12
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