rename two methods to more appropriate names.  added documentation comments.