I realize that we aren't particularly good about this in most of the other physical operators, but could you add some Scala doc here about how this operator works and what the expected performance characteristics are?  Same below.  The goal of the Scala doc for physical operators should be to make it easy for people to understand query plans that are printed out by EXPLAIN.