core: kernel: improved doxygen documentation

there is no doxygen warning for this file