- fix up query update /delete documentation, make warnings
a lot clearer, partial fixes for #3252