Better document the workings of update_showlines.