ah, got it from your comments in the PR. this definitely needs a doc update. +1 otherwise with tests.