add desc of "all" option
code usage section, finalize handwaving on 1.5