core: kernel: improved doxygen documentation

also added param[in] to irq.h and fix order of doxygen endguards