added config option, docs, and tests