update: added note on return values in object methods