This was quite underdocumented. Try to remedy this.
This is part of my answer to !823 (comment 2853681)