Examples
========
-The SQLAlchemy distribution includes a variety of code examples illustrating a select set of patterns, some typical and some not so typical. All are runnable and can be found in the ``/examples`` directory of the distribution. Each example contains a README in its ``__init__.py`` file, each of which are listed below.
-
-Additional SQLAlchemy examples, some user contributed, are available on the wiki at `<http://www.sqlalchemy.org/trac/wiki/UsageRecipes>`_.
+The SQLAlchemy distribution includes a variety of code examples illustrating
+a select set of patterns, some typical and some not so typical. All are
+runnable and can be found in the ``/examples`` directory of the
+distribution. Each example contains a README in its ``__init__.py`` file,
+each of which are listed below.
+
+Additional SQLAlchemy examples, some user contributed, are available on the
+wiki at `<http://www.sqlalchemy.org/trac/wiki/UsageRecipes>`_.
.. _examples_adjacencylist:
"""
-Two examples illustrating modifications to SQLAlchemy's attribute management system.
+Two examples illustrating modifications to SQLAlchemy's attribute management
+system.
-``listen_for_events.py`` illustrates the usage of :class:`~sqlalchemy.orm.interfaces.AttributeExtension` to intercept attribute events. It additionally illustrates a way to automatically attach these listeners to all class attributes using a :class:`~sqlalchemy.orm.interfaces.InstrumentationManager`.
+``listen_for_events.py`` illustrates the usage of
+:class:`~sqlalchemy.orm.interfaces.AttributeExtension` to intercept attribute
+events. It additionally illustrates a way to automatically attach these
+listeners to all class attributes using a
+:class:`.InstrumentationManager`.
-``custom_management.py`` illustrates much deeper usage of :class:`~sqlalchemy.orm.interfaces.InstrumentationManager` as well as collection adaptation, to completely change the underlying method used to store state on an object. This example was developed to illustrate techniques which would be used by other third party object instrumentation systems to interact with SQLAlchemy's event system and is only intended for very intricate framework integrations.
+``custom_management.py`` illustrates much deeper usage of
+:class:`.InstrumentationManager` as well as
+collection adaptation, to completely change the underlying method used to
+store state on an object. This example was developed to illustrate
+techniques which would be used by other third party object instrumentation
+systems to interact with SQLAlchemy's event system and is only intended for
+very intricate framework integrations.
"""
\ No newline at end of file