DOC: consistent doc-string with function declaration, added missing param doc-string for sql.py
Added default values for params in doc-string and added missing param doc-string that are needed for new users. 

small comment, otherwise looks good!
 Done. Thanks! @jorisvandenbossche 
 Thanks!
