I have pushed this now, after putting back a few of the tests I had proposed earlier, as well as a couple of sentences in the docs to hopefully make it clearer how it works.
-- Álvaro Herrera https://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
