clean up

renamed funcitons with shorter names as longer descriptions are part of
documentation. Began checking functions and documenting expected
answers, which also led to some bug corrections.