[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