Add inline declaration/documentation/explanation of functions

[jbergqvist]

Make the code easier to read/understand by adding short explainers of what every function (in the code) is doing.