document some more about row query handling