database/sql: document args, add a couple examples

Fixes issue 3460

R=golang-dev, alex.brainman
CC=golang-dev
https://codereview.appspot.com/7096046