update_ref(): improve documentation