better defaults for params, revised documentation