added documentation and a backing test case

This is all about regfilter being used for keeping query params instead
of pruning them, just a small regex trick.