[Sqlalchemy-tickets] [sqlalchemy] #2852: errors in return_defaults() docs

[sqlalchemy <mi...@zz...>]

#2852: errors in return_defaults() docs
---------------------------+---------------------------------------
 Reporter:  zzzeek         |           Owner:  zzzeek
     Type:  defect         |          Status:  new
 Priority:  high           |       Milestone:  0.9.0
Component:  documentation  |        Severity:  minor - half an hour
 Keywords:                 |  Progress State:  in queue
---------------------------+---------------------------------------
 1. link to ResultProxy.server_returned_default or
 ResultProxy.returned_defaults listed in two different ways and neither is
 linked

 2. the paragraph about "single-row executions" is wrong, this needs to be
 changed to refer to "executemany" executions not being supported by most
 DBAPIs.  The RETURNING DBAPIs except for oracle support multiple row
 UPDATE and DELETE statements.   the doc here should be modified to talk
 more about intent (fetching defaults for a single-row INSERT/UPDATE vs.
 fetching N number of rows for single execution INSERT/UPDATE/DELETE).

--
Ticket URL: <http://www.sqlalchemy.org/trac/ticket/2852>
sqlalchemy <http://www.sqlalchemy.org/>
The Database Toolkit for Python