Logistical changes

tinkering and doc'ing for clarity and my own utility.