core: kernel: improved doxygen documentation

also added param[in] to irq.h and fix order of doxygen endguards
Merge pull request #977 from mehlis/doxygen-irq

core: kernel: improved doxygen documentation