Better document the update() method [BZ#1004434]