zrrichards: Fix update method and improve javadoc