Commented the different functions as a first step in documentation.
Still have to comment review.cpp and the gui related files, but the
function comments are done for now.