add docs for active; tweak tests to match arg order
1.0.3