core: irq: improved doxygen documentation

there is no doxygen warning for this file