Improve doc of Riemann solver
There are some variables which use abbreviations. This might be justified to have it close to how the algorithm is described in a text book. But then all variablenames that are not self-explanatory shoild be documented for better maintainability of the code. In case there is no correspondence to the textbook renaiming to self-explantory name is preferred (style guide)