Improve events documentation by adding cross references,
sub-titles and other markup elements.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>