- add better notes to query.update(), most notably how to deal with a joined table
update, [ticket:2798]
- also do delete, add seealsos, formatting, etc. [ticket:2798]