[doc] fix some stuff in handbook and doxygen

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