code revisions for less cryptic reading