Fixes: #5151

document `listen=True` on `before_create`

Change-Id: I0804ee073044d879eb0decafeb1b358741d69f02

1 files changed, 6 insertions, 1 deletions

diff --git a/lib/sqlalchemy/sql/events.py b/lib/sqlalchemy/sql/events.py
index a6c5c8e28..db80b51e3 100644
--- a/lib/sqlalchemy/sql/events.py
+++ b/lib/sqlalchemy/sql/events.py
@@ -105,12 +105,17 @@ class DDLEvents(event.Events):
          event, the checkfirst flag, and other
          elements used by internal events.
 
-        :func:`.event.listen` also accepts the ``propagate=True``
+        :func:`.event.listen` accepts the ``propagate=True``
         modifier for this event; when True, the listener function will
         be established for any copies made of the target object,
         i.e. those copies that are generated when
         :meth:`_schema.Table.to_metadata` is used.
 
+        :func:`.event.listen` accepts the ``insert=True``
+        modifier for this event; when True, the listener function will
+        be prepended to the internal list of events upon discovery, and execute
+        before registered listener functions that do not pass this argument.
+
         """
 
     def after_create(self, target, connection, **kw):