Add interrupts documentation
Fix example and formatting

Signed-off-by: Nicolae Rosia <Nicolae_Rosia@mentor.com>
Signed-off-by: Alexandre Belloni <alexandre.belloni@free-electrons.com>