sorta in-code documentation, a bit of cleanup, getting ready for P/R commands