[doc] fix some stuff in handbook and doxygen

Merged Bernd Flemisch requested to merge fix/minor-doc-stuff into master

Handbook:

  • don't use deprecated Latex commands \it and \bf
  • use the \Cplusplus macro consistently

Doxygen:

  • put FluidStates group to the right hierarchy level
  • improve wording

Merge request reports