Clarify a statement in the manual about the adiabatic heating term.

Also bring the code comments in sync with what the code actually does.