I think there is a typo at http://www.web2py.com/books/default/chapter/29/06#count,-isempty,-delete,-update :
Just before the next section, "except that it calls the validators for the fields before performing the update. Notice that it only works if query involves a single table. The number of updated records can be found in re*t*.updated and errors will be ret.errors." --
