minor documentation tweaks
pull out a few more variables