make threshold checking optional
document new options