renamed variables for no good reason
some doc blocks