Doc: move icorelistener docs from header to source

Edit for language and style.

Change-Id: I6f22ae90e95537282e4833ca90775683e76e26cf
Reviewed-by: Eike Ziller <eike.ziller@digia.com>