On Tuesday, December 6, 2016 at 12:46:34 PM UTC-5, Ty oc wrote:
>
> Well, if this is so specific, why it isn't documented with the current 
> simple equivalent examples for each supported driver??
>

Note, you can make a pull request if you'd like to see a change in the 
documentation: https://github.com/web2py/web2py-book.
 

> I mean
>
> placeholders is an optional sequence of values to be substituted in or, 
>> if supported by the DB driver, a dictionary with keys matching named 
>> placeholders in your SQL.
>>
>
> Says almost nothing at all.
>

The above is an exact description of the "placeholders" argument. There 
isn't much more to say about it. What is missing is documentation regarding 
the syntax used by each driver for inserting placeholders into raw SQL. I'm 
not sure we should try to document it for every driver, but maybe at least 
SQLite, Postgres, and MySQL, with a mention that further documentation can 
be found with the individual drivers.

Anthony

-- 
Resources:
- http://web2py.com
- http://web2py.com/book (Documentation)
- http://github.com/web2py/web2py (Source code)
- https://code.google.com/p/web2py/issues/list (Report Issues)
--- 
You received this message because you are subscribed to the Google Groups 
"web2py-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to