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. 
