Add the --checked-out flag; expand the docs/comments at the top