crappy docs, lets try that again

diff --git a/lib/sqlalchemy/dialects/mssql/base.py b/lib/sqlalchemy/dialects/mssql/base.py
index facfdd75474b87053d457165a5ae746194e48f82..0faa970777d7e29992d825b287f2fe50275128df 100644 (file)
--- a/lib/sqlalchemy/dialects/mssql/base.py
+++ b/lib/sqlalchemy/dialects/mssql/base.py
@@ -118,11 +118,12 @@ Triggers
 --------
 
 SQLAlchemy by default uses OUTPUT INSERTED to get at newly
-generated primary key values via SEQUENCE columns.   MS-SQL does not 
+generated primary key values via IDENTITY columns or other
+server side defaults.   MS-SQL does not 
 allow the usage of OUTPUT INSERTED on tables that have triggers.
 To disable the usage of OUTPUT INSERTED on a per-table basis,
-specify ``implicit_returning=False`` to each :class:`.Table`
-which has sequences::
+specify ``implicit_returning=False`` for each :class:`.Table`
+which has triggers::
 
     Table('mytable', metadata, 
         Column('id', Integer, primary_key=True), 
@@ -137,7 +138,7 @@ Declarative form::
         __table_args__ = {'implicit_returning':False}
         
         
-This option can also be specified enginewide using the
+This option can also be specified engine-wide using the
 ``implicit_returning=False`` argument on :func:`.create_engine`.
 
 Known Issues

diff --git a/lib/sqlalchemy/engine/__init__.py b/lib/sqlalchemy/engine/__init__.py
index e33dff53bde65204de11327245a6f9c73c8d7d5f..010cc22ddfd008ac5f9bc2a07f4000de7b8cdb75 100644 (file)
--- a/lib/sqlalchemy/engine/__init__.py
+++ b/lib/sqlalchemy/engine/__init__.py
@@ -175,15 +175,14 @@ def create_engine(*args, **kwargs):
         be applied to all connections.  See
         :meth:`~sqlalchemy.engine.base.Connection.execution_options`
 
-    :param implicit_returning=True: When ``False``, the RETURNING
-        feature of the database, if available, will not be used 
-        to fetch newly generated primary key values.   This applies
-        to those backends which support RETURNING or a compatible
-        construct, including Postgresql, Firebird, Oracle, Microsoft
-        SQL Server.  The default behavior is to use a compatible RETURNING
-        construct when a single-row INSERT statement is emitted with no 
-        existing returning() clause in order to fetch newly generated 
-        primary key values.
+    :param implicit_returning=True: When ``True``, a RETURNING-
+        compatible construct, if available, will be used to
+        fetch newly generated primary key values when a single row
+        INSERT statement is emitted with no existing returning() 
+        clause.  This applies to those backends which support RETURNING 
+        or a compatible construct, including Postgresql, Firebird, Oracle, 
+        Microsoft SQL Server.   Set this to ``False`` to disable
+        the automatic usage of RETURNING.
 
     :param label_length=None: optional integer value which limits
         the size of dynamically generated column labels to that many