added tests for new 'db' option
document new 'db' option.