document the new dynamic where clause

nothing much else is documented, but may as well start somewhere.

also, trying to sort out closing issues by commit messages

fixes #2